不修改版本号，如何保证IndexedDB中对象仓库的存在？

首先明确：IndexedDB的设计规则是只有在版本升级触发的onupgradeneeded事件中，才能创建/修改Object Store或索引，所以无法完全不升级版本号就创建缺失的Store，但可以通过临时升级版本的方式修复，同时保留代码中使用的正式版本号不变。

具体实现思路 #

1. 先以原版本号打开数据库，检查目标Object Store是否存在。
2. 如果Store缺失，关闭当前数据库连接。
3. 临时使用一个高于原版本的版本号打开数据库，在onupgradeneeded中创建缺失的Store和索引。
4. 修复完成后关闭临时连接，再以原版本号重新打开数据库（此时数据库实际版本已升级，但原版本号仍可正常打开，不会触发升级）。

代码示例 #

async function ensureObjectStoreExists(dbName, targetVersion, storeName, storeOpts, indexes) {
  return new Promise((resolve, reject) => {
    // 第一步：检查原版本数据库中是否存在目标Store
    const checkRequest = indexedDB.open(dbName, targetVersion);

    checkRequest.onsuccess = (e) => {
      const db = e.target.result;
      if (db.objectStoreNames.contains(storeName)) {
        resolve(db);
        return;
      }

      // Store缺失，关闭当前连接准备修复
      db.close();

      // 第二步：临时升级版本创建Store
      const repairVersion = targetVersion + 1;
      const repairRequest = indexedDB.open(dbName, repairVersion);

      repairRequest.onupgradeneeded = (repairE) => {
        const repairDb = repairE.target.result;
        // 创建Object Store
        const store = repairDb.createObjectStore(storeName, storeOpts);
        // 创建指定索引
        if (indexes) {
          indexes.forEach(idx => {
            store.createIndex(idx.name, idx.keyPath, idx.options || {});
          });
        }
      };

      repairRequest.onsuccess = () => {
        const repairDb = repairRequest.result;
        repairDb.close();
        // 修复完成，重新打开原版本数据库
        const finalRequest = indexedDB.open(dbName, targetVersion);
        finalRequest.onsuccess = () => resolve(finalRequest.result);
        finalRequest.onerror = () => reject(finalRequest.error);
      };

      repairRequest.onerror = () => reject(repairRequest.error);
    });

    checkRequest.onerror = () => reject(checkRequest.error);
    checkRequest.onblocked = () => reject(new Error('数据库被其他页面占用，无法完成修复'));
  });
}

// 调用示例
const DB_NAME = 'your-db';
const DB_VERSION = 5;
const TARGET_STORE = 'your-store';
const STORE_OPTIONS = { keyPath: 'key' };
const STORE_INDEXES = [{ name: 'expiry_idx', keyPath: 'exp' }];

ensureObjectStoreExists(DB_NAME, DB_VERSION, TARGET_STORE, STORE_OPTIONS, STORE_INDEXES)
  .then(db => {
    // 数据库已就绪，可执行读写操作
    console.log('数据库初始化完成', db);
  })
  .catch(err => {
    console.error('数据库修复失败', err);
  });

可能的成因分析 #

• 升级流程竞态：多标签页同时触发数据库升级，导致部分实例的onupgradeneeded逻辑未完全执行。
• 存储空间异常清理：浏览器隐私模式、自动存储空间回收、第三方清理工具可能误删了Store结构，但保留了数据库版本号。
• 浏览器实现bug：部分旧版浏览器的IndexedDB存在兼容性问题，导致版本升级后Store未正确创建。

预防措施 #

• 每次初始化数据库时都执行上述检查修复逻辑，确保Store始终存在。
• 优化升级流程：在onupgradeneeded中添加完整的错误处理，同时处理onblocked事件（提示用户关闭其他标签页重试）。
• 增加日志：记录数据库初始化的状态（如版本号、Store是否存在），方便后续排查问题。

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