Spring Data Neo4j ParentChild关系查询不匹配报错如何解决？

根因说明 #

该报错由两个问题共同导致：

1. Spring Data Neo4j（SDN）与Neo4j数据库版本不兼容。报错内容是SDN内部执行计划校验失败，属于SDN 6.3.x及更早版本对接Neo4j 4.4.x之后版本的已知问题，SDN推导带关联关系的查询时，无法正确匹配Neo4j返回的执行计划结构。
2. 层级实体未配置关联加载策略。SDN默认会全量递归加载children关联节点，当节点层级过深、存在循环关联时，也会触发执行计划生成异常。

修复方案 #

1. 版本适配 #

• 若使用Neo4j 5.x，升级SDN到7.x及以上版本，对应Spring Boot版本升级到3.x及以上
• 若使用Neo4j 4.4.x，将SDN版本固定到6.3.22及以上维护版本，对应Spring Boot 2.7.x最新稳定版

2. 调整实体映射配置 #

给关系注解添加懒加载配置，避免查询根节点时自动加载全量子节点：

@Node
data class Row(
     //其他字段
     @Relationship(type = "ParentChild", direction = Direction.OUTGOING, fetch = FetchType.LAZY)
     var children: List<Row> = emptyList(),
) {}

如果需要查询时关联加载子节点，不要使用SDN自动推导的findByFieldTitle方法，手动编写Cypher查询指定加载深度即可，比如加载2层子节点的示例：

@Query("""
    MATCH (r:Row {fieldTitle: $title})
    OPTIONAL MATCH path = (r)-[:ParentChild*1..2]->(child:Row)
    RETURN r, collect(nodes(path)), collect(relationships(path))
""")
fun findByFieldTitleWithChildren(@Param("title") title: String): List<Row>

3. 幂等创建关系（可选） #

你当前使用的Cypher语句每次执行都会新增重复关系，建议修改为MERGE逻辑避免冗余关系导致的查询异常：

MATCH 
    (parent:Row),
    (child:Row)
WHERE
    child.parentUuid = parent.uuid
MERGE (parent)-[:ParentChild]->(child)

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