CentOS升级为centos-stream后Neo4j无法获取neo4j数据库路由表

1. 检查运行日志定位根因 #

Neo4j 4.3.x默认日志存储路径为/var/log/neo4j/，优先查看debug.log和neo4j.log中的ERROR级日志，可快速定位问题：

• 若日志存在Permission denied类报错，大概率是系统升级重置了目录权限，执行以下命令修复：

  sudo chown -R neo4j:neo4j /var/lib/neo4j
  

• 若日志存在存储文件损坏相关报错，继续走后续一致性检查步骤。

2. 验证Java环境兼容性 #

Neo4j 4.3.x仅支持Java 11版本，系统升级可能默认变更了Java版本，执行命令验证：

java -version

若输出版本不是11.x系列，执行以下命令切换默认Java版本：

sudo alternatives --config java

在弹出的列表中选择Java 11对应的选项即可。

3. 检查端口与配置兼容性 #

系统升级可能重置了防火墙、hosts或端口绑定规则，按以下顺序排查：

• 查看Neo4j主配置文件/etc/neo4j/neo4j.conf，确认以下配置正确：
  • 单节点部署时dbms.mode参数值为SINGLE，不要配置为集群模式的CORE/READ_REPLICA
  • dbms.connector.bolt.enabled值为true，dbms.default_listen_address配置为服务器可访问的IP或0.0.0.0
• 检查Bolt端口7687是否被占用：

  ss -tulpn | grep 7687
  

• 检查防火墙是否放行7474（HTTP端口）、7687（Bolt端口），系统升级可能重置firewalld规则，放行命令参考：

  sudo firewall-cmd --add-port=7474/tcp --permanent
  sudo firewall-cmd --add-port=7687/tcp --permanent
  sudo firewall-cmd --reload
  

4. 数据库一致性检查（无数据修改风险） #

先停止Neo4j服务：

sudo systemctl stop neo4j

执行自带的一致性检查工具，不会修改原有数据：

sudo neo4j-admin check-consistency --database=neo4j

• 若检查无报错，直接重启服务即可
• 若存在轻微一致性报错，可执行恢复命令修复（不会丢失业务数据）：

  sudo neo4j-admin restore --from=/var/lib/neo4j/data/databases/neo4j --database=neo4j --force
  

5. 验证恢复效果 #

启动Neo4j服务后等待30秒，执行以下命令查看数据库状态：

cypher-shell -u 你的用户名 -p 你的密码 "SHOW DATABASES"

若返回结果中neo4j库的状态为online，即可正常执行查询操作。

注意：所有操作前请先完整备份/var/lib/neo4j/data目录，避免误操作导致数据丢失

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