如何解决IndexedDB中嵌套对象handle.name作为索引失效的问题？

可能原因1：索引创建时机晚于数据存储 #

如果先向对象仓库存入了包含handle的条目，之后才在数据库升级流程中创建handle.name索引，已有的历史数据不会自动被纳入新索引。IndexedDB仅会对索引创建后新增或修改的条目构建索引关系。

解决办法 #

在数据库升级的回调函数里，创建索引后遍历所有现有条目，执行一次无修改的更新操作（触发索引重新计算）：

// 数据库升级逻辑内
store.createIndex("handle.name", "handle.name", { unique: true });

// 遍历现有条目，触发索引更新
const cursorRequest = store.openCursor();
cursorRequest.onsuccess = (e) => {
  const cursor = e.target.result;
  if (cursor) {
    // 无需修改内容，仅触发索引同步
    cursor.update(cursor.value);
    cursor.continue();
  }
};

可能原因2：FileSystemFileHandle的name属性无法被索引识别 #

FileSystemFileHandle的name是访问器属性（getter），而非普通数据属性。部分浏览器的IndexedDB实现无法正确解析嵌套对象中的访问器属性值，导致索引无法获取到name内容。

解决办法 #

存储时将name显式转为嵌套对象的普通数据属性，既避免顶层冗余，又能让索引正常生效：

// 存储前包装handle对象，把访问器属性转为数据属性
const storedItem = {
  handle: {
    ...fileHandle,
    name: fileHandle.name
  }
};
// 存入对象仓库
store.add(storedItem);

另外需注意：创建索引时必须确保数据库版本号正确递增，保证升级逻辑被浏览器执行。

内容的提问来源于stack exchange，提问作者Valuator