IndexedDB onupgradeneeded中数据迁移不完全问题排查

我正在更新IndexedDB ObjectStore中的对象，将某属性从Base64编码字符串转换为Blob。尽管数据库版本已成功更新，但该转换操作仅部分完成，导致对象存储处于不一致状态——仅部分条目完成了Blob转换。

核心实现代码如下：

databaseRequest.onupgradeneeded = (event) => {
   
  // [获取objectStore等代码在此]

  if (event.oldVersion < 2) {  
    objectStore.openCursor().onsuccess = function(cursorEvent) {
      let cursor = cursorEvent.target.result;
      if (cursor) {
         let value = cursor.value;
         value.data = convertToBlob(value.data); // 注：convertToBlob为同步方法
         cursor.update(value);
         cursor.continue();
      }
    }
  }
}

推送该更新后，部分用户的ObjectStore中仍存在未转换的旧对象：数据库版本已是最新，但大量旧对象的属性仍为Base64格式。更糟的是，由于版本已更新，无法再次触发升级来修复数据不一致问题。

我想排查问题根源：convertToBlob处理5MB级大Blob是否过于耗时，不适合在onupgradeneeded中执行？在onupgradeneeded中使用游标是否合理？是否因游标异步特性导致数据库版本提前更新，未等转换完成？

问题根源 #

1. 异步游标未等待，升级提前结束
   onupgradeneeded事件的完成判定是回调函数同步执行完毕，和内部的异步操作无关。你代码里的openCursor()的onsuccess是异步触发的，当onupgradeneeded回调跑完，浏览器就会标记版本升级完成，此时游标可能还在遍历，后续的update操作会被直接中断，导致部分数据没转换。

2. 同步大文件处理阻塞主线程
   convertToBlob是同步方法，处理5MB的Base64字符串会占满主线程，阻塞事件循环。这会让游标遍历的onsuccess回调迟迟触发不了，甚至在升级完成后，剩余的游标操作被取消，进一步加剧数据不全的问题。

3. 游标使用合理，但异步逻辑没做等待
   在onupgradeneeded里用游标没问题，但必须保证所有转换的异步操作都做完，升级才算真正完成。你的代码没做这个等待，这是核心问题。

修复方案 #

针对已出现问题的用户（版本已更新） #

没法再触发常规升级，只能在应用启动时主动检查并修复数据：

// 应用初始化时执行
function fixInconsistentData(db) {
  const transaction = db.transaction('你的ObjectStore名称', 'readwrite');
  const objectStore = transaction.objectStore('你的ObjectStore名称');
  const request = objectStore.openCursor();

  request.onsuccess = (e) => {
    const cursor = e.target.result;
    if (cursor) {
      const value = cursor.value;
      // 根据实际格式判断是否为未转换的Base64字符串
      if (typeof value.data === 'string' && value.data.startsWith('data:')) {
        value.data = convertToBlob(value.data);
        cursor.update(value);
      }
      cursor.continue();
    }
  };

  transaction.oncomplete = () => {
    console.log('数据修复完成');
  };
}

// 打开数据库后调用修复逻辑
const dbRequest = indexedDB.open('你的数据库名称', 2);
dbRequest.onsuccess = (e) => {
  const db = e.target.result;
  fixInconsistentData(db);
};

正确的版本升级实现（避免后续再出问题） #

要确保onupgradeneeded等待所有异步转换完成，用Promise封装游标遍历，保证所有操作结束后再让升级完成：

databaseRequest.onupgradeneeded = (event) => {
  const db = event.target.result;
  const objectStore = db.transaction.objectStore('你的ObjectStore名称');

  if (event.oldVersion < 2) {
    // 把游标遍历封装成Promise，方便等待所有操作完成
    function processAllEntries() {
      return new Promise((resolve) => {
        const request = objectStore.openCursor();
        request.onsuccess = (e) => {
          const cursor = e.target.result;
          if (cursor) {
            const value = cursor.value;
            value.data = convertToBlob(value.data);
            // 等当前update完成后，再继续下一个条目
            const updateRequest = cursor.update(value);
            updateRequest.onsuccess = () => {
              cursor.continue();
            };
          } else {
            // 所有条目处理完毕，resolve Promise
            resolve();
          }
        };
      });
    }

    // 等待所有转换完成，避免升级提前结束
    processAllEntries().then(() => {
      console.log('所有数据转换完成');
    });
  }
};

另外，建议把convertToBlob改成异步方法（比如用FileReader或者异步解码逻辑），避免长时间卡主线程，提升转换效率和用户体验。

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