Spring Boot 3.1.0 中 Spring Data Neo4j 存在 Cypher DSL 配置缺失问题，导致 @RelationshipProperties 关系实体无法持久化；需手动注册 Configuration Bean 并指定 Neo4j 5 兼容方言。
spring boot 3.1.0 中 spring data neo4j 存在 cypher dsl 配置缺失问题，导致 `@relationshipproperties` 关系实体无法持久化；需手动注册 `configuration` bean 并指定 neo4j 5 兼容方言。
在使用 Spring Data Neo4j（SDN）构建基于 Neo4j 的 REST API 时，正确建模和持久化带属性的关系（如 ACTED_IN） 是核心需求。但如您所遇，即使实体类（Movie、Person、Roles）结构定义完整，调用 movieService.save(movie) 后仍仅创建节点而未生成关系——这并非模型或逻辑错误，而是 Spring Boot 3.1.0 + SDN 6.4.x 版本中的一个已知配置缺陷。
根本原因在于：Spring Data Neo4j 默认未启用 Cypher DSL 的完整执行能力，尤其在处理 @RelationshipProperties 类型的关系时，缺少显式的 Configuration 声明会导致关系映射被忽略。该问题已在 spring-data-neo4j #2728 中确认，并将在后续版本中修复。
✅ 解决方案：在主应用类或配置类中显式声明 Configuration Bean
@Configuration
public class Neo4jConfig {
@Bean
public Configuration cypherDslConfiguration() {
return Configuration.newConfig()
.withDialect(Dialect.NEO4J_5) // 必须显式指定 Neo4j 5 兼容模式
.build();
}
}⚠️ 注意事项：
- 此配置必须使用 Dialect.NEO4J_5（即使你运行的是 Neo4j 4.x，SDN 6.4+ 默认要求此方言以启用完整关系支持）；
- @Bean 方法名可自定义，但返回类型必须为 org.springframework.data.neo4j.core.schema.Configuration；
- 无需额外依赖，spring-boot-starter-data-neo4j 已包含所需类；
- 若项目中已存在其他 Configuration Bean，请确保仅保留一个（SDN 仅识别首个）。
? 验证效果
添加上述配置后重启应用，再次发送相同 POST 请求：
{
"title": "Matrix",
"description": "Science fiction",
"actorsAndRoles": [{
"person": {
"name": "Keanu Reeves",
"born": "27-01-1963"
},
"roles": ["Neo"]
}]
}✅ 响应中 actorsAndRoles[0].id 将不再为 null（表示关系已成功创建并分配 ID）；
✅ 在 Neo4j Browser 中执行 MATCH (p:Person)-[r:ACTED_IN]->(m:Movie) RETURN p.name, r.roles, m.title 可查到对应关系及属性；
✅ Roles 实体中的 @Property("roles") 列表也将正确写入关系属性。
? 补充建议
- 确保 Roles 类中 @TargetNode 字段类型与关联节点类一致（当前 private Person person; 正确）；
- 若需双向关系（如 Person 也持有 List<Roles>），请在 Person 类中添加对应 @Relationship 字段并设置 direction = OUTGOING；
- 生产环境建议升级至 Spring Data Neo4j 6.4.1+（若已发布），以获得官方修复。
通过这一配置补丁，即可彻底解决 Spring Boot 3.1.x 下 Neo4j 关系持久化“静默失败”的问题，让 @RelationshipProperties 发挥其设计价值——精准建模带上下文的语义关系。
