Neo4j Windows 环境搭建与安装指南
在图数据库开发中,JDK 版本的选择直接关系到 Neo4j 能否正常运行。不同版本的 Neo4j 对 Java 环境有特定要求,配置不当容易引发启动报错。下面咱们一步步来搞定 Windows 下的 JDK 和 Neo4j 环境。
JDK 与 Neo4j 版本对应关系
先确认好版本匹配,避免踩坑:
| 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 |
本文以 Neo4j 4.x 搭配 JDK 11 为例进行演示。
JDK 11 安装及配置
1. JDK 下载
建议从官方或可信镜像源获取。OpenJDK 归档地址:https://jdk.java.net/archive/
2. 解压
将下载的 jdk-11.0.2_windows-x64_bin.zip 解压到指定目录,例如 D:\bigdata\java。注意路径中不要包含中文或空格。
3. 配置环境变量
这一步很关键,配置错了后续命令都跑不起来。
打开系统属性设置
右键点击'此电脑'选择'属性',进入'高级系统设置',然后点击'环境变量'。
新建系统变量
在'系统变量'区域点击'新建',变量名设为 JAVA_HOME,变量值填刚才解压的 JDK 根目录,比如 D:\bigdata\java\jdk-11.0.2。
编辑 Path 变量
找到列表中的 Path 变量,点击'编辑'。新建一条记录,输入 %JAVA_HOME%\bin。这样系统就能在任何目录下识别 java 命令了。
验证配置
打开新的命令行窗口(cmd),输入 java -version。如果能看到版本信息,说明环境变量生效了。
临时测试也可以直接运行:
set PATH=D:\bigdata\java\jdk-11.0.2\bin;%PATH%
Neo4j 安装(Windows)
1. 下载并解压
去 Neo4j 官网下载社区版安装包,解压到独立目录,例如 D:\bigdata\neo4j。
2. 配置环境变量
为了让终端能直接调用 neo4j 命令,需要把 bin 目录加入 Path。
在'环境变量'的 Path 中添加:
D:\bigdata\neo4j\neo4j-chs-community-4.2.3-windows\bin
验证方法:在 cmd 中输入 neo4j-admin.bat --version,看到版本号即成功。
3. 启动 Neo4j
Neo4j 支持多种启动模式,根据场景选一个就行。
主要命令参数:
console:控制台模式,适合开发调试,日志实时可见,关闭窗口服务停止。start:后台服务模式,适合生产或长期运行。stop/restart:停止或重启服务。status:查看当前状态。install-service:注册为 Windows 系统服务,开机自启。
启动示例: 打开 cmd,执行:
neo4j.bat console
启动成功后会显示一系列日志,此时不要关闭窗口,否则服务会中断。
4. 访问 UI 界面
浏览器打开 http://127.0.0.1:7474,即可进入 Neo4j Browser。
5. 登录与修改密码
首次登录默认用户名和密码都是 neo4j。登录后系统会强制要求修改新密码,按提示设置即可。连接成功后,就可以开始写 Cypher 语句操作数据了。
注:以上路径仅为示例,实际部署请根据本地规划调整。

