应排除spring-boot-starter-data-neo4j，显式引入版本对齐的neo4j-ogm-core、api与driver（如3.2.31），http驱动uri须为http://或https://，配置credentials认证，@property标注字段，用包装类，load时指定depth=0，批量操作用saveall。
Neo4j OGM 依赖怎么配才不冲突
Spring Boot 项目里直接加 neo4j-ogm-core 和 neo4j-ogm-http-driver 很容易和 Spring Data Neo4j（SDN）版本打架，尤其用的是 Spring Boot 2.7+ 或 3.x。OGM 已经不被官方主推，但老项目还在用，得手动对齐版本。
- Spring Boot 2.7.x 对应 OGM 3.2.x，用
neo4j-ogm-core:3.2.31+neo4j-ogm-http-driver:3.2.31； - Spring Boot 3.x 默认带 Jakarta EE 9+，而 OGM 3.x 还是 Java EE 8（
javax.*），必须排除掉所有spring-boot-starter-data-neo4j相关 starter，否则编译报NoClassDefFoundError: javax/transaction/TransactionManager； - Maven 里显式声明
neo4j-ogm-api和驱动，别靠传递依赖——OGM 的core、api、driver三者版本必须完全一致，差一个 patch 都可能SessionFactory初始化失败。
OGM SessionFactory 初始化卡住或连不上 Neo4j
常见现象是 SessionFactoryBuilder.build() 长时间无响应，或者抛 Connection refused，但 curl http://localhost:7474 是通的。问题往往出在驱动类型和 URI 格式不匹配。
- HTTP 驱动只认
http://或https://开头的 URI，写成bolt://会静默失败（不报错，但后续所有session.load()都返回 null）； - Bolt 驱动（
neo4j-ogm-bolt-driver）需要额外加neo4j-java-driver依赖，且版本要与 OGM 主版本对齐（比如 OGM 3.2.31 要配neo4j-java-driver:4.4.11）； - 本地 Neo4j Desktop 启动后，默认开启 auth，OGM 的
Configuration必须设credentials，否则连接超时——不是密码错，是根本没发认证头。
@NodeEntity 字段映射失效或保存为空
实体类加了 @NodeEntity，也配置了 SessionFactory，但调用 session.save() 后数据库里只有节点没属性，或者字段名变成全小写带下划线（如 userName → user_name）。
-
@Property注解不能省，尤其是字段名和数据库不一致时：不加的话 OGM 默认用 JavaBean 规则转驼峰，且对 boolean 类型会把isActive映射成active； - 如果用了 Lombok，
@Data或@Getter/@Setter必须确保生成了完整 getter/setter，OGM 依赖反射调用 setter 写入，缺一个就跳过该字段； - 字段类型尽量用包装类（
String,Long,Boolean），原生类型（long,boolean）在 null 值场景下可能触发 NPE 或默认值覆盖。
OGM 查询性能差，load() 或 query() 响应慢
单次 session.load() 耗时几百毫秒，或者 session.query() 返回几千条结果要好几秒——这不是 Neo4j 慢，是 OGM 默认行为太“重”。
立即学习“Java免费学习笔记（深入）”；
- OGM 默认开启深度加载（
depth=1），哪怕你只要一个节点，它也会自动 fetch 关联的 1 层关系节点，关掉：用session.load(MyEntity.class, id, 0)； - 批量操作别用循环
save()，改用session.clear()+session.saveAll(list)，后者走批量 HTTP POST /db/data/transaction/commit，吞吐高 5–10 倍； - 原生 Cypher 查询务必用
session.query()而不是session.load()+ 手动过滤，OGM 对 Cypher 结果做对象映射时，字段名必须和返回的 column 名完全一致（大小写敏感），否则值为 null。
OGM 的坑多数藏在版本对齐和默认行为里，比如 SessionFactory 是单例但线程安全，Session 必须每次用完 close()，不然连接池耗尽；还有就是它不支持复合主键，@Id 只能标在一个字段上——这些细节不踩一遍很难意识到。
