Spring Data Neo4j双向访问带属性关联报错，是否支持双向访问？

结论 #

Spring Data Neo4j（SDN）完全支持双向访问同一条带属性的关联关系，你遇到的报错是SDN 6.1.x版本的已知限制 + 代码映射规则不符合要求共同导致的。

报错原因 #

1. 你对同一个APPEARS_ON关系类型定义了两个不同的@RelationshipProperties类（AppearsOn和AppearsOnReverse），SDN 6.1.x版本的映射上下文无法兼容这种写法，会生成语法错误的Cypher查询，触发Neo4j的查询解析异常。
2. Release类的主键字段命名为大写的Id，不符合SDN默认的属性映射规则，可能额外引发映射错误。

解决方法 #

方法一（推荐）：升级依赖版本 #

将Spring Boot版本升级到2.6.x及以上，对应SDN版本会升级到6.2.x+，该版本已经修复了同一关系类型多属性类映射的问题，你只需要修改Release类的主键字段为小写id即可正常运行原有代码：

// Release.java 仅需要修改主键字段名
@Node
public class Release {
    @Id @GeneratedValue
    private Long id; // 从大写Id改为小写id
    // 其余代码保持不变
}

方法二：不升级版本的兼容方案 #

如果不方便升级依赖，就删除冗余的反向关系属性定义，在需要从Release端查询关联的Song和song_nr属性时，通过自定义@Query实现：

1. 删除AppearsOnReverse类，移除Release类中的songs关联字段。
2. 在ReleaseRepository中添加自定义查询方法：

@Query("MATCH (r:Release)<-[rel:APPEARS_ON]-(s:Song) WHERE id(r) = $releaseId RETURN s, rel.song_nr as songNr")
List<Map<String, Object>> findSongsWithNrByReleaseId(Long releaseId);

查询结果可以手动映射为你需要的DTO使用，避免SDN自动生成错误查询。

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