Neo4j 数据库连接失败排查与解决方案

近期在学习 GraphRAG 时遇到 Neo4j 数据库连接失败的问题，主要表现为 ServiceUnavailable 错误。以下提供两种针对 WSL Ubuntu 环境的解决方案。

方法一：配置 Windows IP 地址连接

1. 在 Windows PowerShell 中执行 ipconfig，获取无线局域网适配器 WLAN 的 IPv4 地址。
2. 在 WSL2 中使用 nc -zv <IP> 7687 测试连通性。
3. 修改 Python 脚本中的 URI，例如：

uri = "bolt://192.168.1.105:7687"

方法二：使用 Docker 拉取镜像

若本地安装不完整，可使用 Docker 运行 Neo4j 容器：

docker run \
  -d \
  --name neo4j \
  -p 7474:7474 -p 7687:7687 \
  -e NEO4J_AUTH=neo4j/your-password \
  neo4j:5.21.0

此方法可成功运行 Python 脚本，但 Neo4j Browser 可能显示旧版界面。

注意事项

• neo4j start 指令需通过 sudo apt install -y neo4j 安装，而非仅通过 pip install neo4j。
• 项目中 import 的 neo4j 库与终端指令中的 neo4j 命令属于不同组件。