如何在Docker内部通过Spring连接Neo4j？连接异常求助

结合你的操作场景，我整理了几个关键的排查和修复步骤，帮你解决容器间的连接异常：

1. 替换过时的--link方式，使用Docker自定义网络 #

--link是Docker早期的容器互联方案，现在官方更推荐用自定义网桥网络，它能提供更稳定的DNS解析和容器间通信能力。

具体操作： #

• 先创建一个专属的自定义网络：

  docker network create neo4j-app-network
  

• 重启Neo4j容器，将其加入这个网络，同时配置Bolt端口允许外部容器访问：

  docker run --publish=7474:7474 --publish=7687:7687 --name=neo4j \
    --network=neo4j-app-network \
    -e NEO4J_AUTH=neo4j/psswd \
    -e NEO4J_dbms_connector_bolt_listen__address=0.0.0.0:7687 \
    -e NEO4J_dbms_connector_bolt_advertised__address=neo4j:7687 \
    neo4j:latest
  

• 启动你的Spring应用容器，同样加入这个网络：

  docker run -p 8080:8080 -t myapp \
    --network=neo4j-app-network
  

2. 修正Neo4j Bolt连接URI的格式 #

你当前用的bolt://neo4j:7687/mydb是错误的格式，Neo4j的Bolt协议指定数据库的正确方式是用查询参数，而非路径：

bolt://neo4j:7687?database=mydb

如果Spring配置里写的是路径格式，会直接导致连接解析失败，这很可能是抛出异常的核心原因之一。

3. 验证Neo4j的Bolt端口监听状态 #

进入Neo4j容器，检查Bolt服务是否正确监听所有网络地址：

docker exec -it neo4j bash
# 查看端口监听情况
netstat -tulpn | grep 7687

如果输出显示0.0.0.0:7687，说明端口已开放给所有地址；如果是127.0.0.1:7687，则说明之前的环境变量配置没生效，需要重新启动Neo4j容器。

4. 测试容器间的网络连通性 #

在Spring应用容器里，先验证DNS解析和基础网络连通：

docker exec -it myapp ping neo4j

如果能ping通，再用nc测试Bolt端口是否开放：

docker exec -it myapp nc -zv neo4j 7687

如果返回成功提示，说明网络层面没问题，问题大概率出在连接URI或Spring配置细节上。

按照以上步骤调整后，应该就能解决容器内Spring应用连接Neo4j的异常问题了。

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