Mac上Docker内node.js访问Neo4j出现Connection closed断连问题

问题根因与排查方案 #

1. 启动命令参数错误

你当前使用的docker-compose -p 7687:7687 -f ./docker-compose.yml up命令存在参数误用：docker-compose的-p参数作用是指定项目名称，并非端口映射。你已经在docker-compose.yml中配置了端口映射规则，错误传入端口格式的字符串作为项目名，可能导致Docker内部网络栈出现异常，触发端口监听失效。
修正方式：直接使用如下命令启动服务

docker-compose -f ./docker-compose.yml up

2. Neo4j连接泄露与连接池耗尽

你的代码使用driver.session()创建会话后没有主动关闭，大量导入数据时会持续占用Bolt连接，最终耗尽Neo4j的连接池上限。Neo4j 3.x版本存在连接满后无日志、停止响应新连接的已知问题，符合你遇到的"无异常日志但端口无法访问"的表现，断连前出现的EPIPE错误就是写入数据时已被服务端断开的连接触发的。
修正方式：

• 每次会话使用完成后主动关闭，避免连接泄露：

const session = driver.session();
try {
  await session.writeTransaction((tx) => tx.run(query, params))
} finally {
  await session.close()
}

• 初始化驱动时添加连接池与存活检查配置：

const driver = neo4j.driver(neo4jUrl, neo4j.auth.basic(user, passwd), {
  maxConnectionPoolSize: 50, // 与Neo4j侧配置匹配
  connectionLivenessCheckTimeout: 2000, // 每次获取连接前校验是否存活
  encrypted: false // 显式关闭加密适配Neo4j 3.x默认配置
});

• 在Neo4j的配置文件neo4j.conf中调高连接上限，放在./db/目录下随镜像构建生效：

dbms.connector.bolt.thread_pool_max_size=100
dbms.connector.http.thread_pool_max_size=100
# 按需调整页缓存大小，避免内存不足导致服务无响应
dbms.memory.pagecache.size=1G

3. Docker Desktop for Mac端口转发bug

如果修正上述配置后问题仍存在，且断连时进入Neo4j容器内部执行curl localhost:7474可以正常访问，说明是Docker Desktop for Mac的内核端口转发模块在短时间大量TCP连接压力下崩溃。其他Mac用户无问题大概率是导入数据量、并发量低于你的场景。
临时修复方案：无需重启整个容器，执行以下命令刷新Neo4j容器的网络即可恢复

docker network disconnect bridge <neo4j容器名> && docker network connect bridge <neo4j容器名>

长期修复方案：升级到Docker Desktop最新稳定版，批量导入数据时控制并发数，避免短时间建立大量TCP连接。

4. 导入方式优化

如果你是导入大批量初始数据，不建议通过neo4j-driver循环执行查询，Neo4j官方提供的离线导入工具效率更高，也不会产生大量短连接导致网络或连接池异常。

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