Kotlin Jetpack Compose协程测试致ObjectBox实体ID自动分配异常

问题根源 #

你遇到的IllegalArgumentException本质是测试过程中ObjectBox的内部ID序列没有被重置，导致后续测试插入ID为0的实体时，内部序列值已经大于等于1，触发了ID校验逻辑。和suspend函数无关，协程只是执行线程的切换，不会影响ObjectBox的ID生成机制；核心问题是测试环境的数据库清理不彻底，残留的数据库文件保留了之前测试的ID序列状态。

解决方案 #

1. 彻底清理BoxStore与测试目录 #

在tearDown()中完成三个关键操作，确保每次测试后数据库完全销毁：

@After
fun tearDown() {
    // 关闭BoxStore连接
    boxStore?.close()
    // 删除ObjectBox相关的所有数据库文件
    boxStore?.deleteAllFiles()
    // 删除整个测试目录，避免残留文件
    File(TEST_DIRECTORY).deleteRecursively()
}

2. 确保每次测试创建全新的BoxStore实例 #

在setUp()中先清理测试目录，再初始化全新的BoxStore，避免复用旧实例：

private lateinit var boxStore: BoxStore

@Before
fun setUp() {
    // 先清理测试目录，防止残留
    File(TEST_DIRECTORY).deleteRecursively()
    // 创建全新的BoxStore构建器
    val boxStoreBuilder = MyObjectBox.builder()
        .directory(File(TEST_DIRECTORY))
        // Android测试需添加上下文，纯JVM测试可省略
        .androidContext(applicationContext)
    boxStore = boxStoreBuilder.build()
}

3. 强制测试用例串行执行 #

如果测试框架默认并行执行测试，多个测试会同时操作同一个目录，导致ID序列混乱。可以通过测试注解强制串行：

• Android测试：在测试类上添加@Execution(ExecutionMode.SERIAL)
• JVM测试：根据使用的测试框架（如JUnit5）配置串行执行规则

验证要点 #

• 每次测试前检查TEST_DIRECTORY是否为空，确保没有残留的objectbox-data等文件夹
• 插入实体前打印boxStore.boxFor<MyEntity>().query().build().count()，确认数据库初始状态为空

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