IndexedDB事务自动管理原子性与一致性:无显式commit/rollback,事务生命周期由请求完成或错误决定;必须用同一readwrite事务封装关联操作,并在事务内校验业务规则。

IndexedDB 通过 transaction(事务) 机制天然支持原子性和一致性:同一事务内的所有操作要么全部成功,要么全部失败回滚,且在执行期间对其他事务可见性受隔离级别约束(实际为 snapshot 隔离)。关键在于正确创建、使用和结束事务,而非手动“开启/提交/回滚”——它没有显式的 commit() 或 rollback() 方法,而是由浏览器自动管理。
事务的生命周期由操作决定
事务不是长期存在的对象,它的活跃期仅限于你向其 objectStore 发起请求(如 add、put、get、delete)并等待完成(oncomplete 或 await)
- 一旦所有请求都完成(包括错误处理),事务自动进入
completed状态,触发transaction.oncomplete - 若任一请求报错(如 key 重复、存储空间不足、权限拒绝),且未被该请求的
onerror捕获并调用event.preventDefault(),事务会自动中止(abort),触发transaction.onabort - 若页面关闭、脚本崩溃或显式调用
transaction.abort(),事务也会中止
必须指定正确的事务模式
事务的 mode 决定了可执行的操作类型和并发行为,直接影响一致性保障:
-
"readonly":只能读取(get、openCursor 等),允许多个只读事务并发执行,不阻塞其他事务 -
"readwrite":可读可写(add、put、delete 等),同一时刻一个 objectStore 最多一个 readwrite 事务活跃;后续对该 store 的 readwrite 请求会排队等待 -
"versionchange":仅由indexedDB.open(..., newVersion)触发,用于升级 schema(创建/删除 objectStore、index),会强制中止所有其他事务
⚠️ 注意:readwrite 事务对不同 objectStore 是独立的。例如同时操作 users 和 logs 两个 store 的 readwrite 事务可以并发,但若都操作 users,则第二个会等待第一个完成。
立即学习“Java免费学习笔记(深入)”;
原子性靠“单事务 + 多请求”实现
要保证多个操作的原子性(比如“扣款 + 记流水”),必须把它们放在同一个 readwrite 事务中发起请求,并确保它们都成功完成:
const db = await openDB(); // 假设已封装好的 Promise 版 open
const tx = db.transaction(["accounts", "transactions"], "readwrite");
const accounts = tx.objectStore("accounts");
const transactions = tx.objectStore("transactions");
<p>// 所有操作共享同一事务
const oldBalance = await accounts.get("user123");
if (oldBalance >= 100) {
await accounts.put({ ...oldBalance, balance: oldBalance.balance - 100 }, "user123");
await transactions.add({ type: "withdraw", amount: 100, time: Date.now() });
} else {
throw new Error("Insufficient balance");
}</p><p>// ✅ 事务在此自然完成(无异常时)
// ❌ 若中间任意 await 抛错(如 put 失败、add 失败),事务自动 abort</p>只要不提前终止(如未 catch 错误导致 unhandledrejection)、不手动 abort,且所有请求都 resolve,整个事务就视为成功提交。
一致性需配合业务逻辑与错误处理
IndexedDB 保证底层数据结构一致(如索引与主键同步),但业务一致性(如余额不能为负)需你自己校验:
- 在事务内做前置检查(如上例中的
if (oldBalance >= 100)) - 监听
tx.onabort做清理或通知(如 UI 提示失败) - 避免在事务外修改依赖数据——因为事务未完成时,其他事务看不到你的变更(snapshot 隔离)
例如:不要先用 get 读出数据,再在事务外计算,最后在事务里写入。应把读+算+写全放进同一事务,防止中间被其他写操作干扰。


















