核心结论
- 场景：在 Java 项目中选择 Neo4j 的访问形态，并完成本地嵌入式与远程 Server 的读写。
- 结论：3.5.x 可用嵌入式；生产推荐 Server + Java Driver（Bolt）；注意驱动与版本强绑定。
- 产出：可复用依赖与示例代码、版本选型矩阵、常见错误速查与修复清单。
版本矩阵
| 已验证 | 说明 |
|---|---|
| 是（基于文中示例） | Neo4j 3.5.x + 嵌入式：GraphDatabaseFactory().newEmbeddedDatabase(…) 可用；适合单机/工具型；不建议生产。存储目录为库目录（如 graph.db/），非单一文件。 |
| 是（基于文中示例） | Neo4j 3.5.x Server + Java 访问：通过 Bolt 访问远端 bolt://host:7687，示例已跑通。建议开启 TLS 并使用参数化查询。 |
| 未验证（建议升级） | Neo4j 4.x Server + Java Driver 4.x：推荐生产；不再支持社区嵌入式模式；需使用 neo4j-java-driver（非 OGM 驱动）。 |
| 未验证（建议生产） | Neo4j 5.x Server + Java Driver 5.x：长期支持线；协议/驱动强绑定，务必版本匹配；默认走加密通道与连接池配置。 |
| 视场景而定 | OGM（对象图映射）：便于实体映射但维护成本更高；与纯 Driver 方案二选一，不建议混用。 |
访问方式
数据库访问
嵌入式数据库
嵌入式 Neo4j 数据库是将数据库引擎直接嵌入到应用程序中的运行模式，无需单独的服务器进程。这种模式通过指定数据库文件存储路径（如 data/graph.db）以编程方式直接访问数据库文件系统。
嵌入式数据库特别适合以下应用场景：
- Java 技术栈项目
- Neo4j 本身是用 Java 开发的
- 嵌入式模式提供原生 Java API（如
GraphDatabaseService） - 示例：
GraphDatabaseService graphDb = new GraphDatabaseFactory().newEmbeddedDatabase(new File("/path/to/database"));
- 独立应用程序
- 不需要网络通信的开销
- 无需额外安装和管理数据库服务器
- 打包部署简单（可包含在 JAR/WAR 文件中）
- 典型用例：桌面应用、移动应用（如 Android）、单机版数据分析工具
- 高性能需求场景
- 消除网络延迟（本地直接访问）
- 减少序列化/反序列化开销
- 事务处理延迟低（微秒级响应）
- 适用场景举例：
- 高频交易系统
- 实时推荐引擎
- 大规模图计算任务
嵌入式模式通过以下方式实现高性能：
- 直接操作磁盘存储文件（如
neostore文件系列） - 利用 JVM 内存管理优化
- 支持 ACID 事务（通过
Transaction接口） - 可配置内存映射缓存策略
服务器模式
Neo4j Server 是部署 Neo4j 图数据库的最佳实践方案，特别适合对操作性、安全性和监控有较高要求的应用场景。作为独立运行的数据库服务器，它具有以下显著优势：
-
跨平台与多语言支持：
