Neo4j Windows 环境搭建与安装实战
在图数据库开发前，确保运行环境稳定是第一步。Neo4j 基于 Java 构建，因此 JDK 的版本匹配至关重要。本文将结合 Windows 系统特性，梳理 JDK 与 Neo4j 的兼容性关系，并演示从环境配置到服务启动的全流程。
JDK 与 Neo4j 版本对应关系
不同版本的 Neo4j 对 Java 运行时环境有明确要求，选错版本可能导致启动失败。以下是常见的版本对照表：
| Neo4j 版本 | JDK 版本 |
|---|---|
| 3.x | Java SE 8 |
| 4.x | Java SE 11 |
| 5.x | Java SE 17 |
| 5.14 及更高版本、5.26 LTS | Java SE 17 和 Java SE 21 |
| 2025.01 | Java SE 21 |
建议优先选择长期支持版（LTS），如 JDK 11 或 17，以获得更好的稳定性。
准备 JDK 环境
下载与解压
前往 Oracle 官网或 OpenJDK 社区获取安装包。以 JDK 11 为例，下载适用于 Windows 的 zip 包后，将其解压至一个无中文、无空格的目录，例如 C:\Program Files\Java。
配置环境变量
为了让系统识别 Java 命令，需要配置两个关键变量：
-
新建 JAVA_HOME 右键点击'此电脑' > '属性' > '高级系统设置' > '环境变量'。在'系统变量'区域点击'新建'，变量名设为
JAVA_HOME，变量值指向 JDK 的安装根目录（如C:\Program Files\Java\jdk-11.0.2）。 -
编辑 Path 变量 在系统变量中找到
Path，选中后点击'编辑'，新建一条记录输入%JAVA_HOME%\bin。这一步是为了让命令行能直接调用java等指令。 -
验证配置 打开新的命令提示符窗口（cmd），输入
java -version。如果能看到类似java version "11.0.2"的输出，说明配置成功。
安装与启动 Neo4j
下载与解压
访问 Neo4j 官网下载社区版安装包。将压缩包解压到你希望存放数据的目录，比如 D:\neo4j。解压后的文件夹结构通常包含 bin、data、plugins 等子目录。
配置环境变量
为了方便在任何目录下启动 Neo4j，同样需要将 Neo4j 的 bin 目录加入系统 PATH。
- 进入'环境变量'设置界面。
- 找到
Path变量并编辑。 - 添加 Neo4j 的 bin 路径，例如
D:\neo4j\neo4j-community-4.2.3\bin。 - 保存后，在 cmd 中输入
neo4j-admin.bat --version验证是否生效。
启动服务
Neo4j 提供了多种启动方式，理解它们的区别有助于调试：
- console：控制台模式。服务在当前窗口运行，日志实时打印。适合开发调试，但关闭窗口即停止服务。
- start：后台服务模式。服务在后台静默运行，适合生产环境。
- stop / restart：用于停止或重启服务。
- install-service：注册为 Windows 系统服务，开机自启。
对于初次尝试，建议使用控制台模式观察启动日志。在 cmd 中切换到 Neo4j 的 bin 目录，执行：
neo4j.bat console
启动成功后，你会看到一系列日志输出。注意此时不要关闭该窗口，否则服务会中断。
访问 Web UI 与登录
浏览器访问 http://127.0.0.1:7474 即可进入 Neo4j Browser 界面。首次登录时，默认账号密码均为 neo4j。
系统会强制要求修改初始密码。输入新密码并确认后，即可连接数据库开始使用。如果遇到连接超时，请检查防火墙设置或确认服务是否已完全启动。
小结
完成上述步骤后，你的 Neo4j 基础环境已就绪。接下来可以根据业务需求调整内存配置或插件扩展。记住，保持 JDK 与 Neo4j 版本的一致性，是避免后续报错的关键。
