WordPress更换网站域名:替换地址、保留旧链接并验收

适用:WordPress单站点更换访问域名,网站内容和数据库仍由自己管理。示例从https://old.example.com切换到https://new.example.com,操作前替换为真实完整地址。本文不处理多站点网络,也不要求同时搬服务器或更换数据库版本。

一、先让新域名具备访问条件

  1. 准备网站文件、数据库和当前站点配置的完整备份,安排一个可接受的维护窗口。
  2. 把新域名解析到预期接入点,在Web服务中绑定新域名,并准备覆盖新域名的有效HTTPS证书。
  3. 通过测试环境或仅自己可访问的验证方式检查新域名,不要等正式地址已经改完才发现证书或站点绑定错误。
  4. 列出支付回调、登录回调、邮件链接、外部接口及资源地址,逐项确认是否需要更换域名。DNS里的邮箱记录不属于本次网页切换,不能顺手删除。

二、确认当前WordPress地址来源

在“设置→常规”核对“WordPress地址”和“站点地址”。如果字段不可编辑,检查wp-config.php是否写死了WP_HOME或WP_SITEURL。WordPress安装在子目录时,两项地址可能不同,不能机械改成相同字符串。

已安装WP-CLI时,用网站原运行账号读取实际目标,以下目录仅为示例:

wp --path=/www/wwwroot/site-example config get DB_NAME
wp --path=/www/wwwroot/site-example option get home
wp --path=/www/wwwroot/site-example option get siteurl

确认数据库是此次要切换的站点,再暂停会改变数据的操作并完成最终备份。不要一边大量接收新订单,一边准备通过旧备份随时回滚。

三、先试运行,再替换站内完整网址

使用能处理序列化内容的工具替换,不要在SQL文件里直接全局改字符串。先执行只读试运行:

wp --path=/www/wwwroot/site-example search-replace \
  'https://old.example.com' 'https://new.example.com' \
  --all-tables-with-prefix --skip-columns=guid --dry-run

检查影响的表均属于本站,数量合理后,去掉--dry-run执行一次。只处理实际使用过的完整地址;不要把短域名片段无差别替换到邮箱、第三方数据和其他站点。

若配置文件中的WP_HOME、WP_SITEURL仍是旧值,同步修改对应原行。清理本站相关缓存,在新地址重新登录,核对首页、文章、图片、表单及后台。保持GUID列不变,不把它当普通页面链接处理。

四、旧地址跳转到对应的新页面

旧域名仍需要有效解析和证书,HTTPS连接成功后浏览器才能收到跳转。对于只服务旧域名的Nginx站点,可在该专用server块配置:

return 302 https://new.example.com$request_uri;

先用临时跳转验证路径和参数是否保留,确认新站没有再跳回旧站后,再改为301永久跳转。支付通知、API和其他POST入口应先在调用方更新为新地址并验收,不能依赖301/302保留请求方法或要求第三方自动跟随跳转。不要把这条规则加进同时承载新域名的server块,否则可能形成循环。

五、用旧链接和新链接一起验收

  1. 抽查首页、深层文章、带查询参数的页面和图片,旧地址应到达对应新地址,而不是全部回首页。
  2. 检查后台登录、找回密码、表单及实际使用的业务回调,链接中不能仍混入旧域名。
  3. 检查页面源代码中的主地址标记、站点地图和重要导航,按实际配置更新。
  4. 保留旧域名和跳转规则,并观察访问日志中的404和循环跳转;不要切换完成就停掉旧域名。

出现问题时先停止继续写入,再按此次改动记录恢复地址与配置。若切换后已经产生新内容,不能直接整库恢复旧备份,否则会丢失新增数据。

相关教程:DNS配置、统一HTTPS与主域名、重定向循环。