前言
Sequelize 是一个 Node.js ORM（Object-Relational Mapping）工具，用于将 JavaScript 对象映射到 SQL 数据库中的关系表中。与其他 ORM 工具相比，Sequelize 提供了更多的功能和灵活性，包括事务支持、预加载关系、复杂查询等。
然而，在使用 Sequelize 过程中，您可能会遇到一些常见的问题，其中之一是 “ER_DUP_ENTRY: Duplicate entry ‘xxx’ for key ‘xxxx’” 错误。这篇文章将介绍这个错误的原因和解决方法，并提供一些示例代码以帮助您更好地理解。
错误原因
在 Sequelize 中，当您使用模型方法如 create 或 bulkCreate 时，如果插入的记录与现有记录中的某些字段唯一索引冲突，则会引发 “ER_DUP_ENTRY: Duplicate entry ‘xxx’ for key ‘xxxx’” 错误。例如，下面是一个 User 模型，其中 email 是唯一索引：
-- -------------------- ---- -------
-- -------
----- - --------- - - ---------------------
----- --------- - --- -----------------------------
----- ---- - ------------------------ -
------ -
----- -----------------
---------- ------
------- -----
--
--------- -
----- -----------------
---------- ------
--
---
------ -- -- -
----- ----------- ------ ---- --- -- ---- --- ------ --- -----
----- ------------- ------ ------------------ --------- ---------- ---
----- ------------- ------ ------------------ --------- ---------- --- -- --------- ----- -----
-----在上面的示例中，{ email: 'foo@example.com', password: 'password' } 记录将被插入 User 表。当您尝试再次插入相同的记录时，Sequelize 将引发 “ER_DUP_ENTRY: Duplicate entry ‘foo@example.com’ for key ‘email’” 错误。
解决方法
为了解决 “ER_DUP_ENTRY: Duplicate entry ‘xxx’ for key ‘xxxx’” 错误，您可以采取以下措施：
1. 检查唯一索引
首先，您应该检查已定义的唯一索引是否正确。您可以使用 Sequelize 的 getIndexes 方法来查看每个模型的索引定义：
-- -------------------- ---- ------- -- ------- ------------------------------- -- ------- -- - -- -------- - --- -- -- -- ---------------- - --- -- - -- -
如果您发现索引定义存在问题，请按需更正并重新同步模型：
// user.js
await User.sync({ force: true }); // Drop and create the table with new index definition2. 指定唯一键冲突处理
其次，您可以指定唯一键冲突时的处理方式。Sequelize 提供了 onDuplicate 选项，它允许您在冲突时执行不同的操作。默认情况下，如果出现冲突，create 方法会引发错误，bulkCreate 方法会跳过冲突的行并继续处理后续行。以下是一些可能的选项：
"error"：如果冲突，则引发错误。这是默认值。"update"：如果冲突，则更新现有记录中的值。这需要您提供要更新的字段。{ customSetter: (existing: Model, incoming: Model) => Promise<void> }：如果冲突，则调用自定义 setter 函数。
下面是使用 onDuplicate 选项解决 “Duplicate entry” 错误的示例代码：
// user.js
await User.create(
{ email: 'foo@example.com', password: 'password' },
{ onDuplicate: { fields: ['email'], update: ['password'] } },
);在上面的示例中，我们指定了 email 字段为唯一索引，并告诉 create 方法，如果冲突，则更新现有记录的 password 值。当您再次运行上面的示例时，您会发现 Sequelize 现在不会引发错误，而是更新现有记录的密码。
3. 处理事务
最后，如果您在处理多条记录时遇到 “Duplicate entry” 错误，您可能需要使用事务来确保数据的一致性。您可以使用 Sequelize 的 transaction 方法创建新的事务，然后在该事务中执行相关的操作。
下面是一个使用事务处理 Create 操作的示例代码：
// user.js
await sequelize.transaction(async (t) => {
await User.create({ email: 'foo@example.com', password: 'password' }, { transaction: t });
await User.create({ email: 'foo@example.com', password: 'password' }, { transaction: t }); // Duplicate entry error inside transaction
});在上面的示例中，我们使用 sequelize.transaction 方法创建了一个新的事务，并将其作为选项传递给 create 方法。由于第二个 create 调用会引发 “Duplicate entry” 错误，因此整个事务将被回滚，所有的操作都不会应用到数据库中。
总结
在本文中，我们介绍了 Sequelize 中的 “ER_DUP_ENTRY: Duplicate entry ‘xxx’ for key ‘xxxx’” 错误，并提供了三种解决方法。您可以检查唯一索引、指定唯一键冲突处理或处理事务来解决这个常见的错误。
虽然本文讨论的是 Sequelize 中的错误，但这些概念同样适用于其他 ORM 工具。我们希望这篇文章可以帮助您更好地使用 Sequelize 或其他 ORM 工具，并更好地管理您的数据库。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/652913567d4982a6ebba542e