Flutter更新版本后ObjectBox数据库与内部存储失效致数据丢失

一、先确认内部存储路径是否变更 #

版本更新后数据丢失最常见的原因是应用存储路径发生了变化，ObjectBox默认存在内部存储的应用专属目录下，路径变化会导致旧数据库无法被读取：

• Android端：如果1.0.1版本修改了applicationId（build.gradle中的包名），或者使用了不同的签名密钥（比如正式版用了新签名、debug版用默认签名），系统会为应用分配新的内部存储目录，旧数据留在原目录无法访问。
  • 验证方式：在两个版本中分别打印存储路径对比：

    final dir = await getApplicationDocumentsDirectory();
    print('ObjectBox存储路径: ${dir.path}');
    

  • 解决：确保版本更新前后applicationId完全一致，正式版本更新必须使用和旧版本相同的签名密钥。
• iOS端：版本更新一般不会变更应用容器路径，但要确认代码中使用的是getApplicationDocumentsDirectory()（持久化目录），而非临时目录（比如getTemporaryDirectory()）。

二、排查ObjectBox Schema与迁移问题 #

ObjectBox依赖实体类的Schema识别数据库，若1.0.1版本实体类有变更但未处理迁移，会导致旧数据库无法打开，ObjectBox会自动创建新数据库，造成数据丢失：

• 检查实体类变更：对比1.0.0和1.0.1的实体类，确认是否有以下变更：
  • 新增/删除字段
  • 修改字段类型
  • 变更实体类名称或@Entity()注解中的name参数
• 处理Schema迁移：
  • 仅新增字段：ObjectBox支持自动迁移，只需更新实体类@Entity()注解中的version号（比如从version:1改为version:2）即可。
  • 字段删除/类型修改：需要手动编写迁移脚本，示例：

    final store = await openStore(
      migrations: [
        Migration(1, 2, (oldBox, newBox) {
          // 在这里处理字段类型转换、数据迁移逻辑
          // 例如将旧字段的内容转移到新字段
        }),
      ],
    );
    

• 查看调试日志：开启ObjectBox调试日志，排查数据库打开失败的错误：

  Store.debugLogs = true;
  

三、检查更新过程中的数据保留配置 #

• Android端：确认AndroidManifest.xml中android:allowBackup未设置为false，如果自定义了备份规则，要确保包含ObjectBox的存储目录（默认是objectbox文件夹）。
• iOS端：检查Info.plist中的配置，避免开启可能清理本地数据的iCloud同步规则，确保数据库文件在版本更新时不会被系统清理。

四、验证数据持久化状态 #

启动应用时先检查数据库是否存在，帮助定位问题：

final dir = await getApplicationDocumentsDirectory();
final dbDir = Directory('${dir.path}/objectbox');
print('ObjectBox数据库目录是否存在: ${dbDir.existsSync()}');

• 如果目录不存在：说明路径或数据库初始化逻辑有问题，回到第一步排查路径。
• 如果目录存在但数据为空：检查查询逻辑是否正确，或者是否在初始化时误删了数据。

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