SDN 6中如何实现双向关系并解决循环映射依赖异常

异常原因 #

你遇到的org.springframework.data.mapping.MappingException: logical cyclic mapping dependency异常，是因为SDN 6无法识别双向绑定的两个@Relationship属于同一条关系，默认会当成两条独立的关系处理，映射实体时陷入无限递归循环。

当前代码中Person和UserAccount都定义了type = "HAS_ACCOUNT"的关系，未指定反向引用规则，所以触发了循环依赖校验。

正确实现双向关系的方案 #

SDN 6的双向关系必须明确关系所有者（主动端）和反向引用端（被动端）：

• 主动端：负责维护关系的存储和更新，@Relationship使用默认的OUTGOING方向即可
• 被动端：仅作为关系的反向映射，需要通过mappedBy属性指定主动端的对应字段名，或者显式声明关系方向为INCOMING，告诉SDN这是同一条关系的反向引用，不需要独立维护。

代码修改示例 #

我们设定Person为关系主动端（即关系方向为Person -> UserAccount），仅需要修改UserAccount类的关系注解即可：

@Node("UserAccount")
class UserAccount(
    @Id
    val username: String,
) {
    // 方式1：使用mappedBy指定主动端Person中对应的字段名，推荐使用，不易出错
    @Relationship(type = "HAS_ACCOUNT", mappedBy = "userAccount")
    // 方式2：显式指定方向为入站，效果等价
    // @Relationship(type = "HAS_ACCOUNT", direction = Relationship.Direction.INCOMING)
    var person: Person? = null
}

Person类和PersonRepository不需要做任何修改。

额外注意事项 #

• 保存关联关系时，仅需要给主动端的关联字段赋值即可：例如关联Person和UserAccount时，执行person.userAccount = userAccount后调用personRepository.save(person)，SDN会自动维护关系，不需要手动给userAccount.person赋值，避免额外的循环问题。
• 不要在实体的toString、equals、hashCode方法中同时包含两边的关联字段，否则会触发序列化/打印时的栈溢出问题，建议仅打印关联对象的主键字段。
• 若业务场景不需要双向查询，直接删除任意一端的关联字段即可从根源避免循环问题。

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