IndexedDB事务天然具备原子性，无需手动提交或回滚：任一操作失败则整个事务自动回滚；所有操作须在同一readwrite事务中并正确处理错误，否则破坏原子性。
IndexedDB 本身不提供显式的“事务提交/回滚”API，但它的事务机制天然具备原子性——只要事务中任意一个操作失败（如键重复、存储空间不足、对象存储不存在等），整个事务会自动中止，已执行的写操作全部撤销。
事务的原子性由 IndexedDB 自动保障
你不需要手动调用 commit() 或 rollback()。IndexedDB 的事务是隐式提交的：当所有请求成功完成、且事务未被主动中止或未发生未捕获错误时，事务自动提交；一旦有请求失败（比如 add() 遇到重复主键），或你在回调中抛出异常、或调用 transaction.abort()，整个事务立即回滚，之前对数据库的修改（add、put、delete）全部失效。
关键点：
- 事务生命周期由你创建的请求决定：事务保持活跃直到所有已发起的请求完成（成功或失败），且没有新的请求被发出
- 所有对同一事务的读写操作共享快照视图（即事务内读不到其他事务未提交的变更）
- 写操作必须在事务处于 active 状态时执行；事务进入 inactive 或 finished 后再调用
put()会直接报错
正确使用 readwrite 事务保证多步写入原子性
当你需要多个写操作（例如先删旧记录、再存新数据）一起成功或一起失败时，必须把它们放在同一个 "readwrite" 事务中，并监听每个请求的 success/error。
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
示例：替换用户配置，要求“删除旧配置 + 写入新配置”要么全成功，要么全不生效：
const request = indexedDB.open("MyAppDB", 1);
request.onsuccess = function(event) {
const db = event.target.result;
const tx = db.transaction(["settings"], "readwrite");
const store = tx.objectStore("settings");
// 先删旧配置（假设 key 是 "userPrefs"）
const deleteReq = store.delete("userPrefs");
deleteReq.onsuccess = function() {
// 删除成功后写入新数据
const putReq = store.put({ theme: "dark", lang: "zh" }, "userPrefs");
putReq.onsuccess = function() {
console.log("配置已原子更新");
};
putReq.onerror = function() {
console.error("写入失败 → 整个事务将自动回滚");
};
};
deleteReq.onerror = function() {
console.error("删除失败 → 事务已中止，后续 put 不会执行");
};
};
避免常见破坏原子性的错误
以下做法会让本应原子的操作失去一致性保障：
- 跨事务操作：把 delete 和 put 分到两个独立事务里 → 它们互不影响，中间可能被其他写入干扰
- 忽略请求错误：只监听 success，不处理 onerror → 错误被静默吞掉，你以为成功了，其实 delete 已失败，但 put 还是执行了（如果它在另一个事务里）
- 异步逻辑跳出事务上下文：比如在 delete.success 里用 setTimeout 延迟执行 put → 此时事务很可能已结束，put 会抛出 InvalidStateError
- 混用不同事务模式：对同一 objectStore，一个事务用 "readwrite"，另一个用 "readonly" 并发读取 —— 虽不破坏原子性，但可能读到旧值；真正危险的是多个 "readwrite" 事务并发写同一 key，IndexedDB 会排队执行，仍能保证每个事务自身原子，但需注意顺序依赖
利用 error 事件统一捕获事务级失败
比逐个监听每个请求更简洁的方式是监听事务本身的 onerror 和 onabort：
const tx = db.transaction(["users"], "readwrite");
tx.onerror = function(event) {
console.error("事务因某个请求失败而中止", event.target.error);
// 此处可触发 UI 提示、重试逻辑等
};
tx.onabort = function() {
console.log("事务被显式中止或遇到不可恢复错误");
};
tx.oncomplete = function() {
console.log("事务所有请求成功完成，已提交");
};
const store = tx.objectStore("users");
store.put({ id: 1, name: "Alice" }, 1);
store.put({ id: 1, name: "Bob" }, 1); // 主键冲突 → 触发 tx.onerror
注意：onerror 在任意请求失败时触发，onabort 在事务被中止（如调用 tx.abort()）或发生严重错误（如磁盘满）时触发，oncomplete 仅在全部请求成功后触发。
