GCP上Docker部署的Neo4j可访问UI但无法完成登录认证

故障排查与解决步骤 #

按照以下顺序操作即可解决认证失败问题：

• 验证端口转发规则：Neo4j UI走7474端口，但实际认证、数据交互走bolt协议的7687端口，你需要确认本地到GCP服务器的端口转发同时包含两个端口，以SSH隧道为例，完整命令为：

  ssh -L 7474:127.0.0.1:7474 -L 7687:127.0.0.1:7687 [你的GCP服务器登录信息]
  

  仅转发7474端口会出现能访问UI但始终认证失败的情况。
• 清理旧数据残留：NEO4J_AUTH环境变量仅在Neo4j首次启动、数据目录为空时生效，若你之前启动过服务，旧的账户密码已经保存在数据目录中，后续修改NEO4J_AUTH不会生效。执行以下命令清理残留后重启服务：

  docker compose down neo4j
  docker compose rm -v neo4j
  docker compose up -d neo4j
  

• 检查自定义启动脚本：你在配置中挂载了自定义的docker-entrypoint.sh，官方镜像默认的启动脚本会读取NEO4J_AUTH设置初始密码，若你的自定义脚本没有实现该逻辑，配置的账户密码会失效。你可以临时注释掉volumes中docker-entrypoint.sh的挂载行，用官方默认脚本重启服务验证。
• 本地验证账户有效性：进入Neo4j容器内部直接验证密码是否正确，执行命令：

  docker exec -it neo4j cypher-shell -u neo4j -p connect
  

  若该命令能成功登录，说明账户密码配置正确，问题出在外部网络连接规则；若仍提示认证失败，说明密码未正确配置，回到前两步重新操作。
• 检查neo4j.conf配置：确认你修改的配置中dbms.connectors.default_listen_address值为0.0.0.0，若设置为127.0.0.1会导致容器外的请求无法访问bolt端口，出现认证失败报错。

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