ZCenter 服务因数据库连接异常无法启动或接口报错，如何排查？

问题说明

本文用于排查Gateway仍可访问，但Base、Portal或业务服务无法启动、接口失败或间歇性超时的数据库问题。本文聚焦数据库可用性、认证、连接池、只读状态和磁盘容量；Flyway脚本校验问题应使用独立KB排查。

现象

• 服务启动日志出现Unable to obtain connection、Communications link failure或Application run failed。
• 接口返回应用失败信息，日志出现HikariPool、Connection is not available, request timed out。
• 数据库返回Access denied for user、Unknown database、Too many connections或只读错误。
• Gateway端口正常，但目标服务未注册、返回503或业务响应失败。
• 数据库磁盘空间不足、inode耗尽或InnoDB写入失败。

适用环境

• 产品：ZCenter
• 版本：5.1.0
• 组件：MariaDB/MySQL、HikariCP、Base、Portal及各业务服务

可能原因

• 数据库进程未运行、3306不可达或防火墙/路由异常。
• 应用实际配置的地址、数据库名、账号、密码或主机授权不正确。
• 多个ZCenter服务和副本连接总量超过数据库max_connections。
• 慢查询、长事务、锁等待或数据库I/O慢导致Hikari连接池耗尽。