Spring Boot集成Neo4j OGM时关系实体生成额外冗余节点问题

你遇到的关系被转为节点存储的问题，核心是Spring Data Neo4j的映射规则使用错误，具体原因和修复方案如下：

问题根因 #

1. 如果你使用的是6.x及以上版本的Spring Data Neo4j：
   该版本已经完全废弃了原有OGM的@RelationshipEntity直接作为节点属性的映射逻辑，改用@RelationshipProperties定义关系属性。你的旧写法会被框架误将Familyrelation识别为普通节点实体，因此两个关系实例被当做节点存入数据库，就出现了你看到的两个带relationship-id属性的额外节点。
2. 如果你使用的是5.x及配套OGM的旧版本：
   你在Person类的关系集合字段上的@Relationship注解没有指定方向，同时双向关系的重复保存触发了OGM的状态检测bug，导致关系实体被错误持久化为节点。

修复方案 #

方案1：适配SDN 6+ 标准写法（推荐） #

1. 改造关系属性类，替换注解：

// 用@RelationshipProperties替代@RelationshipEntity
@RelationshipProperties
public class Familyrelation {
  @Id
  @GeneratedValue
  private Long relationshipId;
  // 用@TargetNode标注关系指向的目标节点
  @TargetNode
  private Person relatedPerson;
  // 可按需添加其他关系属性，比如亲属类型、关联时间等

  public void setRelatedPerson(final Person relatedPerson) {
    this.relatedPerson = relatedPerson;
  }
  // 其他getter/setter保持不变
}

2. 调整Person类的关系字段配置：

@Data
@Node("Person")
public class Person {
  @Id
  @GeneratedValue
  private Long id;
  private String name;
  private int age;

  // 明确指定关系类型和方向
  @Relationship(type = "FAMILY", direction = Relationship.Direction.OUTGOING)
  private Set<Familyrelation> relations = new HashSet<>();

  // 修正方法名拼写错误，避免和Lombok生成的setter冲突
  public void addRelation(Familyrelation relation) {
    this.relations.add(relation);
  }
  // 其他代码保持不变
}

3. 简化数据创建逻辑，避免重复保存：

final Person person1 = new Person();
person1.setName("Bob");
person1.setAge(40);

final Person person2 = new Person();
person2.setName("Alice");
person2.setAge(30);

// 建立Bob到Alice的亲属关系
final Familyrelation familierelasjon1 = new Familyrelation();
familierelasjon1.setRelatedPerson(person2);
person1.addRelation(familierelasjon1);

// 如需双向关系，添加Alice到Bob的关联
final Familyrelation familierelasjon2 = new Familyrelation();
familierelasjon2.setRelatedPerson(person1);
person2.addRelation(familierelasjon2);

// 仅保存一次person1即可，框架会自动级联保存person2和所有关联关系
personRepository.save(person1);

方案2：兼容旧版OGM写法 #

1. 给Person类的关系字段补充方向配置：

@Relationship(type = "FAMILY", direction = Relationship.OUTGOING)
private Set<Familyrelation> relations = new HashSet<>();

2. 确认启动类的@EntityScan注解包含了Familyrelation所在的包，确保OGM能正确识别它是关系实体而非节点实体。
3. 不要重复保存关联节点，同一个事务内仅保存一次根节点即可，不需要单独保存person2。

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