fishzzz

WordPress 提示「建立数据库连接时出错」:原因和恢复步骤

故障排查更新于 约 1700 字

这句提示的意思很直接:PHP 连不上 MySQL。原因只有几类,要么连接信息不对,要么 MySQL 没在运行,要么 MySQL 在运行但不接受新连接

数据库连接出错的排查顺序
  1. MySQL 是否在运行进程和端口是否存在
  2. 核对连接信息库名、用户、密码、主机
  3. 看 MySQL 日志启动失败或崩溃的原因
  4. 查是否被 OOM 杀系统日志里的 killed process
  5. 查连接数和表连接数是否满、表是否损坏
  6. 加守护和监控挂了自动拉起并通知

先确认 MySQL 是否在运行

登上服务器,运行下面任意一条

systemctl status mysqld
ps aux | grep -E "mysqld|mariadbd"

宝塔面板可以直接在「软件商店」里看 MySQL 是否显示已启动。共享主机没有服务器权限的,打开主机面板里的 phpMyAdmin,能登录说明数据库服务本身是好的

  • MySQL 没在运行:先启动它,网站一般会立刻恢复,然后再查为什么会停(看后面几节)
  • MySQL 在运行:问题在连接信息、连接数或者数据表上

核对 wp-config.php 里的连接信息

打开网站根目录的 wp-config.php,看这四行

define('DB_NAME', '数据库名');
define('DB_USER', '数据库用户名');
define('DB_PASSWORD', '数据库密码');
define('DB_HOST', 'localhost');

最常见的出错场景

  • 刚搬家或换服务器,新环境的数据库名、用户名和旧的不一样
  • 在面板里改过数据库密码,但没同步改这里
  • 数据库在另一台服务器或云数据库上,DB_HOST 要写对地址和端口
  • localhost 连不上但 127.0.0.1 能连,这是 socket 路径的问题,改成 127.0.0.1 试试

用命令行验证这组信息能不能登录:mysql -u 用户名 -p -h 主机 数据库名,能进去说明信息没错

MySQL 启动不了:看错误日志

MySQL 的错误日志一般在 /var/log/mysqld.log,宝塔在 /www/server/data/主机名.err。常见的启动失败原因

  • 磁盘满了:日志里有 No space left on device。用 df -h 看磁盘,清理日志、备份文件、binlog 后再启动
  • 配置不合理:调过 innodb_buffer_pool_size 之类的参数,超出了可用内存
  • 数据文件损坏:异常断电或被强制杀掉后,InnoDB 恢复失败。这种情况先把整个数据目录复制一份再动手,可以用 innodb_force_recovery 逐级尝试启动并导出数据

MySQL 时不时自己停掉:多半是内存不够

网站隔几天就报一次数据库连接错误,重启 MySQL 就好,过几天又出现。这是最典型的内存不足:系统内存用完时,Linux 会挑一个占内存最多的进程杀掉,MySQL 往往就是它

确认方法

dmesg -T | grep -i "killed process"
grep -i "out of memory" /var/log/messages

看到 mysqld 被杀的记录就能确定。我遇到过一台服务器 MySQL 被杀掉以后一直没人发现,网站停了将近两个月

处理办法

  1. 找出是谁吃光了内存,常见的是 PHP-FPM 进程数开得太大,几十个进程每个几十 MB
  2. 按内存大小调整 PHP 进程数和 MySQL 的缓冲池
  3. 加一块 swap 作为缓冲
  4. 调低 MySQL 被系统杀掉的优先级(oom_score_adj)
  5. 加一个守护脚本,MySQL 不在运行时自动拉起并记录时间

MySQL 在运行,但连不上

  • 连接数满了:日志或报错里有 Too many connections。被刷流量、慢查询堆积都会占满连接,先查清楚是什么在占连接,再考虑调大 max_connections
  • 数据表损坏:网站部分页面能打开,后台提示某张表需要修复。在 wp-config.php 加 define('WP_ALLOW_REPAIR', true);,访问 /wp-admin/maint/repair.php 修复,用完删掉这行
  • 数据库用户权限被改:用户还在,但对这个库没有权限了

共享主机上的情况

共享主机的数据库在主机商那边,你能做的是确认连接信息正确、数据库空间没超限。如果信息都对还是连不上,或者 phpMyAdmin 也打不开,直接联系主机商,多半是他们的数据库服务器出了问题

恢复以后做这几件事

  • 立即备份一次数据库,并确认自动备份在正常工作
  • 加上可用性监控,网站出现数据库错误时能第一时间知道
  • 排查清楚是哪一次操作或哪个原因导致的,避免同样的事再发生

网站一直报数据库连接错误、或者 MySQL 起不来不敢动手的,可以发我看看,先判断数据是否完好

把情况发我,先免费看一眼

不用先付钱。我看完直接告诉你问题在哪、能不能做、要多久

先免费判断改动前完整备份工程师本人对接淘宝担保交易

周一至周日 09:00 – 22:00

每天 09:00 – 22:00 在线

微信二维码扫码加微信fishzzz233 淘宝店铺二维码手机淘宝扫码平台担保交易

先免费判断,再决定做不做每天 09:00 – 22:00 · 一般 1 小时内回复

淘宝下单平台担保交易