indexeddb事务原子性需复用同一transaction实例,多事务独立回滚且性能差;多表操作须声明全部store名;需监听所有请求成败并手动兜底;大数据量应分块但保持每块内原子性。

IndexedDB 的事务原子性不是自动生效的,必须把所有关联操作塞进同一个 transaction 实例里,否则根本没用。
为什么单独调用多次 add() 不等于原子操作
常见错误是循环里对每条数据都新开一个事务:
dataList.forEach(item => {
const tx = db.transaction('store', 'readwrite'); // ❌ 每次都新建事务
tx.objectStore('store').add(item);
});
这实际触发了 N 个独立事务。任一失败只回滚那一条,其余照常写入——完全失去原子性。更糟的是性能极差,浏览器可能直接拒绝过多并发事务。
- 每个
transaction是隔离的,彼此不感知对方成败 -
db.transaction()调用即创建新事务,和上一个事务毫无关系 - 想“批量”必须复用同一个
tx实例,而不是拼凑多个请求
多表写入时必须显式声明所有 objectStore 名称
比如要同时往 'users' 和 'logs' 里写数据,但只写了:
const tx = db.transaction(['users'], 'readwrite'); // ❌ 缺少 'logs'
后续 tx.objectStore('logs').put(...) 会直接抛 NotFoundError,且容易被忽略——尤其没监听 tx.onabort 时,错误静默吞掉。
- 事务创建时传入的 store 名数组,是硬性白名单,不是可选列表
- 读和写涉及的不同表,都得列全:
db.transaction(['users', 'logs'], 'readwrite') - 别依赖
tx.objectStoreNames动态判断,它返回的是已打开的 store,不是你“打算用”的
事务生命周期必须手动兜底,不能靠“自然结束”
IndexedDB 没有 commit(),事务靠“所有请求完成 + 无新请求加入”自动关闭。但现实里很容易卡住:
- 漏监听某个
request.onsuccess或onerror,事务就一直挂着,阻塞后续写操作 - 在
onsuccess回调里又发起异步操作(如setTimeout或Promise.then),新请求脱离事务上下文,报InvalidStateError: Transaction is inactive - 长时间未响应的请求可能被浏览器强制终止,但不一定会触发
onabort,得同时监听tx.onerror和tx.onabort
可靠做法是:每个请求都绑定空的 onsuccess 和 onerror,哪怕只写 req.onsuccess = () => {},防止静默失败。
大数据量必须分块,但分块不等于放弃原子性
一次性塞 10000 条进一个事务,大概率触发内存溢出或事务超时被 abort。但分块不是让你每个块开新事务——而是按块提交,每块内部仍保持原子性:
async function bulkAddInChunks(db, storeName, dataList, chunkSize = 200) {
for (let i = 0; i
<p>注意:不同 chunk 之间没有原子性保障。如果第 3 块失败,前两块已写入,无法回滚。真需要全量原子(比如迁移整库),只能硬扛——或换服务端做事务协调。</p>
<p>最容易被忽略的一点:事务 abort 后,已成功执行的请求不会回滚;它只保证“本次事务内未完成的操作全部失效”。所以事务外的副作用(比如修改全局变量、发网络请求)必须严格剥离,否则原子性形同虚设。</p>前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











