数据库连接失败主因是配置错误、服务未启或权限不足，需依次检查PHPCMS的database.php配置文件中主机、端口、库名、账号密码及编码设置是否正确，确认MySQL服务已运行且3306端口未被阻断，通过命令行测试账号连通性并确保用户拥有对应访问权限，最后查看/caches/error_log.php等日志文件获取具体错误提示以精准定位问题，按步骤排查即可解决多数连接故障。
PHPCMS数据库连接失败通常由配置错误、服务状态异常或权限问题引起。直接检查以下几个关键环节，能快速定位并解决问题。
检查数据库配置文件
PHPCMS的数据库连接信息保存在配置文件中，路径一般为 /caches/configs/database.php。打开该文件，确认以下内容是否正确：
- hostname：数据库服务器地址，本地通常是 localhost 或 127.0.0.1，远程需填写实际IP
- port：数据库端口，默认为 3306，若修改过需对应调整
- database：数据库名称，确保该库已创建且名称无拼写错误
- username 和 password：登录账号和密码，注意区分大小写
- charset：建议设为 utf8 或 utf8mb4，避免编码不一致导致连接中断
修改后清除缓存（可删除 /caches/configs/* 下相关缓存文件），再尝试访问。
确认MySQL服务运行状态
数据库服务未启动是常见原因。通过命令行或系统工具检查MySQL是否正常运行：
立即学习“PHP免费学习笔记（深入）”；
- Linux系统执行：systemctl status mysql 或 service mysql status
- Windows系统可在“服务”管理器中查看 MySQL 是否正在运行
若服务未启动，尝试手动开启。同时检查是否有端口被占用或防火墙阻止了3306端口。
测试数据库账户权限与连通性
即使用户名密码正确，也可能因权限不足导致拒绝连接。使用如下方法验证：
- 通过命令行登录：mysql -u 用户名 -p -h 主机地址，输入密码看能否进入数据库
- 若无法登录，可能是用户没有从当前主机访问的权限，需登录MySQL执行授权命令： GRANT ALL PRIVILEGES ON 数据库名.* TO '用户名'@'访问主机' IDENTIFIED BY '密码'; FLUSH PRIVILEGES;
例如允许远程访问时，'访问主机' 可设为 '%'，但生产环境应限制IP以保障安全。
查看错误日志定位具体原因
PHPCMS会在日志中记录连接失败详情，路径通常为 /caches/error_log.php 或PHP的error_log文件。
关注以下几类常见报错：
- Can't connect to MySQL server：网络不通或服务未启动
- Access denied for user：账号密码错误或权限不足
- Unknown database：数据库名不存在或拼写错误
结合错误提示反向排查，效率更高。
基本上就这些。多数连接问题都出在配置写错、服务没开或权限不对。一步步核对，基本都能解决。
