IndexedDB游标遍历时不能直接delete()或put()？你需要知道的正确操作方式
在使用HTML5 IndexedDB进行前端数据存储时，许多开发者会遇到一个常见误区：在游标遍历过程中，试图直接对当前记录执行删除或更新操作，结果发现操作无效或引发异常。这并非IndexedDB的设计缺陷，而是其事务安全机制的体现。正确的理解是：游标的核心职责是安全地“读取”和“导航”，而数据的“变更”操作（如删除、更新）应通过对象存储（objectStore）发起独立的请求来完成。
简而言之，你**无法直接对游标对象调用 `delete()` 或 `put()`** 方法，但可以通过游标获取记录的主键（key），然后基于该主键发起独立的删除或更新请求——这是标准、安全且推荐的做法。
为什么在游标遍历中直接操作是危险的？
根本原因在于IndexedDB游标的工作机制。当游标被打开时，它实际上创建了一个数据的“只读快照视图”。在游标的活跃生命周期内（即未调用 `continue()` 或未自动结束前），其看到的数据状态是固定的。
若在同一事务内对同一对象存储进行写入操作，虽然引擎可能不会立即报错，但会导致难以预料的结果：
- 记录被意外跳过：尤其在升序遍历中，若删除当前记录，后续的 `continue()` 可能因数据移位而定位到错误的下一条记录，造成遍历遗漏。
- 更新操作“不可见”：对数据所做的更新，正在迭代的游标无法感知，因为它仍基于打开时的快照状态进行读取。
- 破坏事务一致性：在事务提交前，读写操作的交叉进行可能导致最终结果不可预测，违背了事务的隔离性原则。
因此，直接操作并非被明令禁止，但其带来的风险远大于便利性，极易导致数据错乱。
标准解决方案：两步走策略——先收集键，再批量操作
最稳妥且推荐的方法是分离“数据筛选”与“执行操作”两个步骤。首先利用游标遍历所有记录，收集符合条件的主键；待游标遍历结束后，再使用这些主键统一进行批量删除或更新。这种方式逻辑清晰，且完全符合IndexedDB的事务模型。
例如，若要删除所有状态为“inactive”的用户记录，可参考以下代码：
立即学习“前端免费学习笔记（深入）”；
const transaction = db.transaction(['users'], 'readwrite');
const store = transaction.objectStore('users');
const request = store.openCursor();
const keysToDelete = [];
request.onsuccess = function(event) {
const cursor = event.target.result;
if (cursor) {
if (cursor.value.status === 'inactive') {
keysToDelete.push(cursor.primaryKey); // 先缓存主键
}
cursor.continue();
} else {
// 游标遍历结束，此时安全地执行批量删除
keysToDelete.forEach(key => store.delete(key));
}
};
更新数据的正确流程：读取→修改→独立写入
更新操作的逻辑与此类似。应避免在游标内直接调用 `put(cursor.value)`，正确的三步流程是：
- 在游标遍历过程中，读取 `cursor.value` 和 `cursor.primaryKey`。
- 基于原值创建新的对象（建议使用解构或深拷贝，避免直接修改原对象引用）。
- 待游标结束后，统一调用 `store.put(newValue, key)` 将新值写入数据库。
需要注意一个细节：若更新逻辑对数据一致性要求极高（例如基于当前值的计数器累加），且应用可能存在高并发写入，则“快照”隔离可能不足。此时，更严谨的做法是在写入事务中，通过 `store.get(key)` 重新获取最新值，进行计算后再调用 `put()`，以确保数据的最终正确性。
进阶应用：必须边遍历边处理的场景如何应对？
当数据量极大无法一次性缓存所有主键，或需要向用户提供实时进度反馈时，“先收集再操作”的模式可能不再适用。
一种可行的替代方案是采用“递归游标”模式。其核心思路是：每处理完一条记录后，基于当前记录的主键重新打开一个新的游标（从下一条记录开始），从而在逻辑上分离读写操作。
function deleteInactiveUsers(transaction, store, lastKey = null) {
// 若提供了上一个键，则从此键之后开始查询
const range = lastKey ? IDBKeyRange.lowerBound(lastKey, true) : null;
const request = store.openCursor(range);
request.onsuccess = function(event) {
const cursor = event.target.result;
if (!cursor) return; // 遍历结束
if (cursor.value.status === 'inactive') {
// 执行删除
store.delete(cursor.primaryKey);
// 删除后，递归调用自身，从当前被删除的键之后继续遍历
deleteInactiveUsers(transaction, store, cursor.primaryKey);
} else {
// 不符合条件，继续正常迭代
cursor.continue();
}
};
}
⚠️ 重要提醒：即使采用这种递归方式，也必须确保整个操作流程（包括所有递归调用）都发生在同一个 `‘readwrite’` 事务内。如果事务因异步操作等原因提前关闭，后续所有的 `delete` 或 `put` 请求都将失败。
总结而言，IndexedDB游标的设计哲学非常明确：其核心价值在于提供一种安全、可控的数据遍历机制，而非作为数据变更的入口。真正的增、删、改操作，务必通过对象存储的独立方法（`add`、`put`、`delete`）来完成，并依赖事务系统保证其原子性与一致性。理解并遵循这一原则，就能有效规避绝大多数与游标相关的数据操作陷阱。
