使用idb包添加无显式键记录时遇ConstraintError问题求助

问题描述 #

我正在使用idb包向应用数据库添加新记录，对象仓库创建代码如下：

const dbEditorStore = db.createObjectStore("myStore", { keyPath: "id", autoIncrement: true });
dbEditorStore.createIndex("resultIndex", "resultId", { unique: false });
dbEditorStore.createIndex("tabIndex", "tabId", { unique: false });

当尝试不指定显式键添加数据时，出现错误：

ConstraintError: Key already exists in the object store.

添加数据的代码（未传入键参数）：

await db.add("myStore", data);

原本以为配置自动递增键后，IndexedDB会自动处理键的生成，无需手动指定，因此对此错误感到困惑。想请教问题出在哪里，以及此场景下正确的数据添加方式是什么？

补充信息：若在add调用中指定键名，会触发另一个错误：

DataError: Failed to execute 'add' on 'IDBObjectStore': The object store uses in-line keys and the key parameter was provided.

问题原因 #

冲突的核心原因是你传入的data对象已包含id字段，且该字段的值在对象仓库中已存在。

当对象仓库配置了keyPath: "id"和autoIncrement: true时，IndexedDB的规则是：

• 若传入的数据包含id字段，会直接使用该值作为键，不会自动生成递增键
• 只有当数据中没有id字段时，IndexedDB才会自动生成递增键值，并赋值给数据的id字段

add方法要求键必须唯一，因此当data.id已存在时，就会抛出ConstraintError。而第二个错误是因为，使用内联键（keyPath指定）时，add不允许额外传入键参数——键的取值只能来自数据本身，手动传键违反规则。

正确解决方式 #

根据需求选择以下两种方案：

方案1：移除数据中的id字段，依赖自动递增 #

如果希望完全由IndexedDB生成键，在调用add前删除data里的id：

// 解构移除id字段，确保传入的数据不含id
const { id, ...newData } = data;
await db.add("myStore", newData);

或者直接构造不包含id的对象传入。

方案2：使用put方法替代add #

如果需要保留data中的id，同时允许键存在时更新记录，改用put方法：

await db.put("myStore", data);

put的逻辑是：键不存在则插入新记录，键已存在则覆盖原有记录，不会触发冲突错误。

内容的提问来源于stack exchange，提问作者Mike Lischke