一、检查基础配置
数据库连接失败的首要排查点是配置文件参数准确性。在织梦CMS系统中需检查以下文件：
data/common.inc.php：核对$cfg_dbhost、$cfg_dbuser等参数config.cache.php：验证$db_name与数据库实例名称是否匹配include/config_database.php：确认端口号与字符集设置
建议使用数据库管理工具（如phpMyAdmin）进行参数比对，排除拼写错误和多余空格。
二、验证数据库权限
权限不足是常见故障原因，需执行以下检查：
- 登录MySQL执行
SHOW GRANTS FOR '用户名'@'主机' - 确保包含
GRANT ALL PRIVILEGES ON 数据库.*权限 - 检查用户是否限制为本地访问（@localhost）
特殊场景下需注意：云数据库可能要求开放外网访问白名单。
三、排查服务与网络
服务器环境问题可通过分层检测定位：
- 服务状态：执行
systemctl status mysql验证运行状态 - 端口连通：使用
telnet 127.0.0.1 3306测试连接 - 防火墙规则：检查iptables/ufw是否放行3306端口
阿里云等云服务器需同步检查安全组配置。
四、高级调试方法
当常规检查无效时，建议采用以下方法：
| 工具 | 用途 |
|---|---|
| mysqli_connect_error | 捕获PHP连接错误详情 |
| MySQL日志 | 查看/var/log/mysql/error.log |
| tcpdump | 抓包分析网络握手过程 |
数据库连接故障的排查应遵循从简到繁的原则：先验证配置参数准确性，再检查权限与服务状态，最后进行网络层诊断。建议建立配置检查清单，使用mysqldump定期备份关键数据。
