You need to enable JavaScript to run this app. Dart/Flutter打开Java端创建的ObjectBox数据库文件报错求助
优惠活动
大模型
产品
解决方案
定价
更多

Dart/Flutter打开Java端创建的ObjectBox数据库文件报错求助

根因说明

ObjectBox 模型中的flags值4对应的是NOT_NULL约束,代表Java端该字段被定义为不可为空类型,不允许存储null值。你在Dart端重构模型时没有显式声明对应约束,生成模型时flags字段被自动移除,新旧模型校验不匹配,直接打开旧数据库就会抛出对应异常。
Linux端的崩溃是数据库初始化失败触发的进程终止,日志中提到的checkPlatformOverride等报错是Debug模式下的Flutter调试组件无关警告,无需处理。

解决方案

1. 对齐所有属性flags配置

对照Java端模型JSON的flags字段,在Dart实体类的对应属性上补充注解,常见flags对应关系如下:

  • flags=4(NOT_NULL):给属性添加@Property(flag: PropertyFlag.notNull)注解,同时Dart端字段声明为非空类型,不要加?可空标记
  • flags=1(ID_SELF_ASSIGNABLE):给ID字段添加@Id(assignable: true)注解
  • flags=2(INDEXED):给属性添加@Index()注解
  • flags=8(UNIQUE):给属性添加@Unique()注解
  • flags=16(TRANSIENT):给属性添加@Transient()注解
    你之前因为Java继承特性复制到子类的字段,只要保证字段ID、UID和Java端完全一致,补充对应注解即可,不会影响兼容性。

2. 重新生成模型校验一致性

所有注解补充完成后,执行命令重新生成Dart端模型:

flutter pub run build_runner build

打开生成的模型JSON文件,核对所有字段的id、type、flags和Java端的模型JSON完全一致,没有缺失项。

3. 验证旧数据库加载

模型完全对齐后,将原有数据库文件放到Dart应用对应目录运行,即可正常加载旧数据库,不会再抛出flag变更异常。

内容的提问来源于stack exchange,提问作者LXJ

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 22:45:01