网页提示 “Error establishing a database connection” 的常见原因

网页提示 “Error establishing a database connection” 的常见原因

常用排查/解决步骤（按重要性顺序）

1. 确认数据库服务是否在运行
   • 登录服务器，检查 MySQL/MariaDB 状态（systemctl status mysql），必要时重启。
   • 若使用面板（如宝塔），在“软件商店”或“服务管理”中启动 MySQL。
2. 核对 wp-config.php 中的数据库信息
   • 确认 DB_NAME、DB_USER、DB_PASSWORD、DB_HOST 完全正确，且用户拥有对应数据库的全部权限。
   • 若不确定，可在 phpMyAdmin 或命令行使用相同凭据尝试登录。
3. 检查数据库是否损坏
   • 通过 phpMyAdmin 的 “检查表” 功能或运行 REPAIR TABLE 表名; 修复。
   • 若损坏严重，可从最近的备份恢复数据库。
4. 修复 WordPress 核心文件
   • 重新上传官方最新的 WordPress 核心文件（除 wp-content 之外），覆盖可能损坏的文件。
5. 检查服务器资源
   • 查看 CPU、内存、磁盘 I/O、MySQL 连接数等指标，必要时升级主机或优化查询。
6. 排除 SELinux / 防火墙影响
   • 临时关闭 SELinux (setenforce 0) 验证是否为 SELinux 导致；若是，调整策略后再恢复。
   • 确认防火墙未阻止 3306（或自定义端口）对外访问。
7. 确认 PHP 与 MySQL 兼容性
   • 若近期升级 PHP，检查 MySQL 密码哈希方式；必要时在 MySQL 中执行 SET SESSION old_passwords=0; 并重新设置密码。
8. 禁用所有插件/主题
   • 通过 FTP 将 wp-content/plugins 重命名为 plugins_old，同理 themes，确认是否仍报错。
   • 若错误消失，逐个恢复插件/主题定位冲突点。
9. 联系主机商
   • 若以上均未解决，可能是底层硬件或网络故障，及时向提供商请求日志和支持。

小结

“Error establishing a database connection” 并非单一原因导致，而是 配置错误、服务器不可达、数据库损坏、文件损坏、资源不足、兼容性问题 等多因素的综合表现。按照上表的分类逐项排查，通常可以在 几分钟到数小时 内定位并恢复正常。若仍无法解决，建议保留完整错误日志并向专业技术支持提供，以便进一步诊断。