Ubuntu部署Neo4j后执行cypher-shell遇连接拒绝问题求助

以下是针对Ubuntu环境下该问题的排查和解决步骤：

• 检查Neo4j实际监听端口
  先确认Neo4j是否真的在监听cypher-shell依赖的Bolt端口（默认7687），执行命令：

  ss -tulpn | grep neo4j
  

  如果输出里没有:7687的监听记录，说明Bolt连接器没正常启动，直接跳去配置文件检查环节。

• 核对Neo4j核心配置
  找到Neo4j的配置文件neo4j.conf（通常路径是/etc/neo4j/neo4j.conf或安装目录下的conf/文件夹），重点检查以下参数：

  • 确保Bolt协议已启用：dbms.connector.bolt.enabled=true
  • 确认监听地址允许本地连接：dbms.default_listen_address=0.0.0.0 或者 dbms.connector.bolt.listen_address=127.0.0.1:7687
  • 端口配置与默认一致（如果改了端口，后续连接要对应）：dbms.connector.bolt.listen_address=:7687
    修改完配置后重启Neo4j服务：

  sudo systemctl restart neo4j
  

• 查看服务启动日志排查异常
  光看systemctl status neo4j可能看不到细节，直接看实时日志：

  journalctl -u neo4j -f
  

  重点找包含bolt、listen、error的日志行，比如端口被占用、权限不足导致连接器初始化失败的信息。

• 排查本地防火墙拦截
  Ubuntu默认的ufw防火墙可能会挡住7687端口，先查看当前规则：

  sudo ufw status
  

  如果没看到允许7687端口的规则，添加并生效：

  sudo ufw allow 7687
  sudo ufw reload
  

  也可以临时关闭防火墙测试是否能连接：sudo ufw disable，如果能连上就说明是防火墙的问题。

• 指定地址/端口手动连接
  尝试显式指定连接地址和端口，避免默认配置不匹配：

  cypher-shell -a bolt://127.0.0.1:7687 -u neo4j -p 你的初始化密码
  

  如果之前修改过Bolt端口，把7687换成自定义的端口号。

• 验证用户密码有效性
  如果你是第一次启动Neo4j，可能还没初始化密码，或者密码输入错误。可以通过Neo4j浏览器端（默认访问http://localhost:7474）尝试登录，确认密码是否正确——密码错误有时候也会触发类似“连接拒绝”的模糊提示。

内容的提问来源于stack exchange，提问作者Nguyen Anh Viet