WordPress 搬家失败，大多输在这两个文件上
WordPress 网站搬家（把整站从旧服务器迁到新服务器）技术上并不复杂，但失败案例有一个高度集中的分布：绝大多数事故出在两个文件上——数据库连接配置写错的 wp-config.php，和数据库里存着旧域名绝对地址的内容表。为什么这两个文件如此容易出问题？因为文件迁移本身只是”复制”，而 WordPress 的正常运行依赖配置与环境、内容与域名的三重一致性。解决这个问题的方法是把搬家拆成”备份 → 迁移 → 改配置 → 换域名 → 验证”五步，每一步都有明确的完成标准。本文按这个顺序展开，重点讲 wp-config 与域名替换这两个高危环节的实操细节，帮助你在不中断现有服务的前提下完成迁移。
迁移窗口的规划原则是”旧站保底”：整个过程中旧服务器保持运行，直到新站验证通过、域名解析切换满 72 小时后再退役。这样任何一步出问题都有回退空间，不会出现网站两头都打不开的窘境。
第一步：完整备份与文件数据库迁移
搬家的原料是两样东西：整站文件和数据库导出。在旧服务器上：
- 用 cPanel 文件管理器或 FTP（文件传输协议）把站点根目录（通常是 public_html）整体压缩下载，确认压缩包含 wp-content、wp-admin、wp-includes 和全部根目录 PHP 文件
- 通过 phpMyAdmin 导出全部数据库为 .sql 文件，导出前在”自定义”里选择 utf8mb4 编码，避免中文内容变乱码
- 把文件压缩包和 .sql 文件上传到新服务器对应位置并解压、导入；cPanel 环境可以在”备份”功能里直接还原，[VPS](https://cn.hostease.com/vps/) 环境用命令行
mysql -u用户 -p 数据库名 < 备份.sql导入 - 完成标准：新服务器上文件数量与旧站一致、phpMyAdmin 里能浏览到全部数据表且 wp_posts 表有内容
这一步最常见的疏漏是只备份了主题和插件目录、漏掉根目录的散文件（如自定义的 .htaccess、favicon 和上传到根目录的验证文件）。养成”整目录打包”的习惯可以一次性规避。
第二步：wp-config.php 连接信息修改
新服务器上的数据库账号密码几乎必然与旧服务器不同，这一步要做的是把 wp-config.php 里的三行连接信息改成新环境的值：
define( 'DB_NAME', '新数据库名' );—— cPanel 创建的库名带主机前缀，抄全称define( 'DB_USER', '新数据库用户' );—— 确认该用户在新环境里被授予了此库的全部权限define( 'DB_PASSWORD', '新密码' );—— 复制时注意不要带首尾空格- 顺手核对
$table_prefix的值（如 wp_ 或自定义前缀），它必须与导入的库实际表前缀一致，不一致会触发”安装向导”页面
改完这一步，如果新旧域名相同，理论上新站已经能通过临时地址访问；如果报”Error establishing a database connection”，回到三行连接信息逐项核对——这一报错在搬家场景下的排查思路与本站此前文章讨论的一致，先配置文件、后数据库端。主机面板与密码管理的相关细节，可以参考本站服务器分类的 cPanel 使用教程。
第三步：域名替换与搬家后验证
如果搬家伴随换域名（或临时地址验证后需要切回正式域名），必须替换数据库里的旧地址。WordPress 把站点 URL 存在数据库里，文章内链、图片地址也大量使用绝对路径，只改 wp-config 里的 siteurl 是不够的。可靠的做法有两种：
- 插件方式（推荐）：新站正常打开后台后，安装 Better Search Replace 插件，把数据表里的
http://旧域名替换为https://新域名，先勾选”试运行”（dry run）预览影响行数，确认无误后再正式执行 - SQL 方式：在 phpMyAdmin 里对 wp_posts、wp_postmeta 等表执行 UPDATE 替换；注意序列化字段（widget 配置等）用裸 SQL 替换可能破坏数据结构，这也是更推荐插件方式的原因——它能正确处理序列化串
替换完成后按清单验收：前台首页、文章页、图片附件、分类归档逐一打开；后台登录、发表一篇测试文章；检查”设置 → 常规”里的 WordPress 地址与站点地址是否为新域名；用浏览器无痕模式访问，排除本地缓存干扰。全部通过后，把域名解析切换到新服务器 IP，保留旧服务器 72 小时作为回退。搬家后也建议把新旧环境的加载速度做个对比，验证迁移是否带来了预期的性能收益。
总结与行动建议
整个搬家的关键节点可以浓缩成一句话：文件数据库整体迁移是地基，wp-config 三行连接信息是开关，域名替换是收口，三者按序完成、每步验证，搬家就不会出事故。规划上记住两个数字——解析切换前把 TTL（DNS 记录缓存时间）提前 48 小时降到 300 秒，切换后旧服务器保留 72 小时，这两个窗口能覆盖绝大多数解析传播延迟。
建议把本文的五步流程存为模板，每次迁移直接套用；与搬家强相关的数据库维护和登录安全话题，可以延伸阅读本站 WordPress 分类的系列文章，服务器环境与资源选型可参考 VPS 主机与 虚拟主机产品页。如果你希望零手工操作，也可以直接联系主机商申请迁移协助——但无论谁来执行，wp-config 的连接信息和域名替换结果都值得你亲自打开页面验证一遍。总结：建议今天就按清单备份旧站，本周末前完成迁移演练；如果你需要更稳妥的过渡，可以考虑先用测试域名在新服务器上完整走一遍五步流程再切换正式域名。