将PostgreSQL数据导入Neo4j遇连接拒绝错误，求排查方向

操作场景 #

尝试通过Neo4j的APOC工具从本地PostgreSQL导入数据，执行步骤如下：

1. 加载JDBC驱动：

CALL apoc.load.driver("org.postgresql.Driver")

2. 执行导入查询：

WITH "jdbc:postgresql://localhost:5432/graph-test?user=kt" as url
CALL apoc.load.jdbc(url,"os.operating_systems") YIELD row AS line
MERGE (o:Os {name: line.name})
MERGE (of:OsFamily {name: line.familly})
MERGE (o)-[:FROM]->(of)

执行后出现错误：

Failed to invoke procedure `apoc.load.jdbc`: Caused by: java.net.ConnectException: Connection refused (Connection refused)

可能的原因及排查方向 #

1. PostgreSQL服务未正常运行或端口不匹配 #

• 检查PostgreSQL进程状态：Linux/macOS用ps aux | grep postgres，Windows在服务管理器中查看PostgreSQL服务是否启动
• 验证端口配置：查看PostgreSQL配置文件postgresql.conf中的port参数，确认是否为5432，与JDBC URL中的端口一致

2. JDBC URL配置错误 #

• 数据库名验证：确认graph-test是PostgreSQL中已存在的数据库，可通过psql -l命令列出所有数据库核对
• 用户权限与密码：URL仅指定了user=kt，若该用户需要密码，需补充&password=你的密码；同时确认kt用户拥有访问graph-test数据库和os.operating_systems表的权限
• 地址解析问题：如果Neo4j以容器方式运行，localhost会指向容器内部而非宿主机，需将URL中的localhost替换为宿主机的实际IP地址（如192.168.1.100）

3. PostgreSQL连接限制 #

• 检查pg_hba.conf配置：确认文件中存在允许本地（或Neo4j所在环境）连接的规则，例如本地连接可添加：

  host  all  kt  127.0.0.1/32  scram-sha-256
  

• 修改配置后需重启PostgreSQL服务使规则生效

4. 驱动与APOC版本兼容性问题 #

• PostgreSQL JDBC驱动：确保驱动版本与PostgreSQL服务器版本匹配（如PostgreSQL 15对应驱动42.5.x），且驱动jar文件已放入Neo4j的plugins目录
• AOC版本：确认APOC版本与Neo4j版本兼容（如Neo4j 5.x对应APOC 5.x系列），版本不兼容可能导致连接逻辑异常

5. 防火墙或网络拦截 #

• 检查本地防火墙是否拦截了5432端口，可临时关闭防火墙测试连接，或在防火墙中添加允许PostgreSQL端口的入站规则

快速验证建议 #

先通过PostgreSQL客户端工具测试本地连接是否正常，执行命令：

psql -h localhost -p 5432 -U kt graph-test

如果该命令无法连接，说明问题出在PostgreSQL本身的配置或服务状态，与Neo4j/APOC无关。

内容的提问来源于stack exchange，提问作者Scorpioooooon21