WordPress更换网站域名:替换地址、保留旧链接并验收
适用:WordPress单站点更换访问域名,网站内容和数据库仍由自己管理。示例从https://old.example.com切换到https://new.example.com,操作前替换为真实完整地址。本文不处理多站点网络,也不要求同时搬服务器或更换数据库版本。
一、先让新域名具备访问条件
- 准备网站文件、数据库和当前站点配置的完整备份,安排一个可接受的维护窗口。
- 把新域名解析到预期接入点,在Web服务中绑定新域名,并准备覆盖新域名的有效HTTPS证书。
- 通过测试环境或仅自己可访问的验证方式检查新域名,不要等正式地址已经改完才发现证书或站点绑定错误。
- 列出支付回调、登录回调、邮件链接、外部接口及资源地址,逐项确认是否需要更换域名。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块,否则可能形成循环。
五、用旧链接和新链接一起验收
- 抽查首页、深层文章、带查询参数的页面和图片,旧地址应到达对应新地址,而不是全部回首页。
- 检查后台登录、找回密码、表单及实际使用的业务回调,链接中不能仍混入旧域名。
- 检查页面源代码中的主地址标记、站点地图和重要导航,按实际配置更新。
- 保留旧域名和跳转规则,并观察访问日志中的404和循环跳转;不要切换完成就停掉旧域名。
出现问题时先停止继续写入,再按此次改动记录恢复地址与配置。若切换后已经产生新内容,不能直接整库恢复旧备份,否则会丢失新增数据。
相关教程:DNS配置、统一HTTPS与主域名、重定向循环。