macOS上ObjectBox单元测试遇DbDetachedException：无法解析分离实体关联

我之前在macOS环境下做ObjectBox单元测试时，也碰到过一模一样的io.objectbox.exception.DbDetachedException: Cannot resolve relation for detached entities错误，尤其是实体带自关联的ToOne和Backlink ToMany的时候，踩了不少坑！下面给你说说问题根源和解决办法：

问题本质 #

这个错误的核心原因是：你当前操作的实体处于游离（detached）状态——也就是它还没有被持久化到ObjectBox的数据库中，没有和Box实例建立关联。不管是自关联的ToOne，还是带@Backlink的ToMany，都需要实体处于附着（attached）状态（即已经被Box存储过），ObjectBox才能正常解析和追踪这些关联关系。

具体解决方案 #

1. 确保关联实体先持久化再操作关联 #

在测试代码里，必须先把关联链上的所有实体存入Box，让它们变成附着状态，再去访问或修改关联。举个实际的代码例子：

// 初始化测试用的ObjectBox Store（建议用内存数据库，避免污染本地数据）
val testStore = MyObjectBox.builder()
    .inMemory()
    .name("category-test-db")
    .build()
val categoryBox = testStore.boxFor(Category::class.java)

// 1. 先持久化父分类，使其变为attached状态
val parentCategory = Category(title = "电子产品")
categoryBox.put(parentCategory)

// 2. 创建子分类，关联已持久化的父分类后，再持久化子分类
val childCategory = Category(title = "手机")
childCategory.parent?.target = parentCategory
categoryBox.put(childCategory)

// 3. 此时访问关联就不会报错了
val fetchedChild = categoryBox.get(childCategory.id!!)
println(fetchedChild.parent?.target?.title) // 正常输出"电子产品"

2. 禁止直接操作未持久化实体的关联 #

如果你的测试代码里直接new出实体就去访问它的Backlink ToMany，比如下面这种写法，百分百会触发异常：

// 错误示例：未持久化就操作关联
val parent = Category(title = "父分类")
val child = Category(title = "子分类")
child.parent?.target = parent
// 这里直接访问parent的backlink集合会报错，因为parent还没被存储
parent.children?.size

一定要先把父、子实体都存入Box，再去操作关联关系。

3. 检查@Backlink注解的正确性 #

你的实体类中@Backlink的to属性必须严格对应ToOne关联的字段名。比如你的ToOne字段叫parent，那Backlink应该写成：

@JvmField
@Backlink(to = "parent") // 这里的"parent"要和ToOne字段名完全一致
var children: ToMany<Category>? = null

字段名写错会导致ObjectBox无法识别关联关系，间接触发这个异常。

4. 单元测试中正确初始化Store #

macOS的单元测试环境里，建议使用内存数据库初始化Store，避免测试数据污染本地开发数据库，同时也能加快测试速度：

@Before
fun setupTestStore() {
    // 每次测试前初始化全新的内存Store
    val store = MyObjectBox.builder()
        .inMemory()
        .build()
    // 后续测试操作都基于这个store的box
}

总结 #

只要记住一个核心原则：所有需要操作关联关系的实体，必须是已经被ObjectBox持久化（处于attached状态）的。游离状态的实体没有被ObjectBox追踪，自然无法解析关联，也就会抛出这个异常。

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