如何迁移已部署WordPress至新服务器？数据库连接失败排查

这种数据库连接错误在迁移WordPress时太常见了，我帮你梳理几个最可能的原因和排查步骤，一步步来肯定能解决：

1. 先确认wp-config.php的参数没有遗漏错误 #

别只盯着DB_NAME、DB_USER、DB_PASSWORD这三个，很容易忽略DB_HOST！

• 如果新服务器的数据库是本地的，DB_HOST可能是localhost或者127.0.0.1（有些环境下这俩不是完全等价的，比如用socket连接的情况）；如果是远程数据库，要填数据库服务器的IP或域名。
• 为了精准定位问题，你可以写个简单的测试脚本验证连接：创建test-db.php文件，内容如下：

<?php
$db_host = '你的DB_HOST值';
$db_user = '你的DB_USER值';
$db_pass = '你的DB_PASSWORD值';
$db_name = '你的DB_NAME值';

$conn = mysqli_connect($db_host, $db_user, $db_pass, $db_name);
if (!$conn) {
    die("连接失败，具体错误：" . mysqli_connect_error());
}
echo "数据库连接成功！";
mysqli_close($conn);
?>

把这个文件传到新服务器的网站根目录，访问它，会得到具体的错误信息（比如“拒绝访问”“数据库不存在”），比WordPress的模糊提示有用太多。

2. 检查数据库用户的权限与主机限制 #

这是最容易踩坑的点之一：

• 新服务器的数据库用户，有没有被授权访问目标数据库？而且要注意主机限制：原数据库用户可能只允许localhost访问，但如果新服务器用的是远程连接，或者用户权限绑定了原服务器IP，就会被拒绝。
• 登录新服务器的数据库管理工具（比如phpMyAdmin或MySQL命令行），执行这条命令查看用户权限：

SHOW GRANTS FOR '你的DB_USER'@'你的DB_HOST值';

如果没有看到对目标数据库的权限，执行授权命令：

GRANT ALL PRIVILEGES ON `你的DB_NAME`.* TO '你的DB_USER'@'你的DB_HOST值';
FLUSH PRIVILEGES;

记得把占位符换成你的实际值，比如本地连接的话，DB_HOST填localhost或者127.0.0.1。

3. 确认数据库服务是否正常运行 #

有时候新服务器的MySQL/MariaDB服务根本没启动：

• 对于Ubuntu 16.0+/CentOS 7+这类systemd系统，用命令检查状态：

sudo systemctl status mysql  # 或者mariadb，看你装的是哪个

• 如果服务没运行，启动它：

sudo systemctl start mysql
sudo systemctl enable mysql  # 设置开机自启，避免下次重启又出问题

4. 排查防火墙或网络限制 #

如果数据库不在新服务器本地：

• 确认新服务器的防火墙允许出站访问3306端口（MySQL默认端口）；同时数据库服务器的防火墙要允许新服务器的IP访问3306端口。
• 如果你用的是CentOS/RHEL系服务器，还要检查SELinux是否阻止了PHP访问数据库：可以临时关闭测试sudo setenforce 0，如果能正常连接了，再去配置SELinux的规则（别一直关着，不安全）。

5. 验证数据库本身是否正常 #

• 登录数据库，确认你配置的DB_NAME确实存在，而且里面有WordPress的表（比如wp_posts、wp_options这些）。
• 有时候导入数据库时会出错（比如编码不兼容、导入中断），导致表缺失或损坏，可以重新导入一次，注意导入时的编码要和原数据库一致（推荐用utf8mb4）。

6. 最后检查wp-config.php的细节问题 #

• 有没有拼写错误？比如把DB_NAME写成DB_NMAE，或者引号配对错误？
• 如果密码里有特殊字符（比如!@#$），有没有用单引号包裹？双引号可能会解析特殊字符导致密码错误。
• 确认DB_CHARSET和DB_COLLATE和原配置一致，编码不匹配也可能导致连接异常。

内容的提问来源于stack exchange，提问作者Martin AJ