structuredClone() 可安全用于 IndexedDB 写入，前提是原始数据不含函数、undefined、Promise 等禁用类型；需确保事务内批量操作用 Promise.all() 等待完成，并在版本升级时更新数据库结构。
直接用 structuredClone() 处理数据再存入 IndexedDB 是可行的，但关键不在“能不能克隆”，而在于“克隆后能否被 IndexedDB 接受并正确写入”。IndexedDB 的数据写入依赖结构化克隆算法（Structured Clone Algorithm），而 structuredClone() 正是该算法的公开接口——二者底层一致。所以真正要解决的，是让原始嵌套实体先变成 IndexedDB 可接受的格式，再确保事务中操作不中断、不越界。
确认原始数据是否可被 IndexedDB 存储
IndexedDB 只接受可结构化克隆的数据。即使你用 structuredClone() 克隆成功，若原始对象含以下内容，仍无法写入：
- 函数（
() => {}）、undefined、Promise、WeakMap、WeakSet - DOM 节点（如
document.body）、window或 class 实例（含自定义 getter/setter） - 带循环引用但未被
structuredClone()正确处理的对象（极少见，它默认支持）
✅ 安全类型包括：Date、RegExp、Map、Set、ArrayBuffer、Blob、File、嵌套普通对象/数组——这些 structuredClone() 能保留原类型，IndexedDB 也能原样存。
⚠️ 若原始实体含禁用项（比如一个带方法的 class 实例），需先剥离或转换：提取纯数据字段，或用 Object.assign({}, obj) + 手动映射关键属性。
在事务中安全写入克隆后的数据
IndexedDB 事务生命周期极短，**所有写操作必须在事务活跃期内发起**。常见错误是克隆后用 for 循环逐个 add()，结果只写入第一个——因为事务在第一个请求返回前就自动终止了。
- 批量写入推荐用
Promise.all()包裹所有IDBRequest.onsuccess，确保全部完成才认为事务成功 - 单次写入可直接调用
objectStore.put(clonedData, key)，无需额外克隆（只要数据本身已兼容） - 不要在事务外缓存
objectStore引用；事务一结束，该引用立即失效，后续调用抛TransactionInactiveError
示例（安全批量写入）：
const tx = db.transaction('users', 'readwrite');const store = tx.objectStore('users');
const clonedItems = items.map(item => structuredClone(item));
const requests = clonedItems.map(item => store.add(item));
await Promise.all(requests.map(req => new Promise((res) => {
req.onsuccess = () => res();
req.onerror = () => res(); // 简化处理，实际应 reject
})));
避免版本升级遗漏导致克隆无效
如果你新增了需要存储的字段类型（例如原来没存 Map，现在要存），而数据库结构未更新，IndexedDB 不会报错，但 onupgradeneeded 不触发 → createIndex() 不执行 → 查询失败。这和克隆无关，却是常见“存了却查不到”的根源。
- 每次修改数据结构（如新增索引、调整 keyPath），必须递增
open()的版本号（如从 1 改为 2） - 在
onupgradeneeded中显式调用objectStore.createIndex()，否则按新字段查询会全表扫描 - 开发调试时可用 DevTools → Application → Clear storage 清空数据库强制重试，但不可用于线上
要不要每次都手动调用 structuredClone()？
多数情况下不需要。IndexedDB 内部写入时自动执行结构化克隆，和 structuredClone() 同源。你只需保证传入的数据本身是可克隆的。
- 仅当原始数据含不可克隆项（如函数），且你又无法提前清洗时，才需用
structuredClone()尝试“过滤式克隆”——但它会直接报错，不如提前校验 - 更稳妥的做法是：统一用
try/catch包裹structuredClone()，失败则降级为JSON.parse(JSON.stringify())（仅限纯数据对象，注意Date变字符串、undefined丢失）
一句话总结：克隆是手段，不是目的；重点是让数据干净、事务稳定、结构匹配。
