WordPress站点迁移后无法加载图片资源问题求助

该故障的核心原因是站点迁移过程中未完成全量的旧域名/旧路径替换，站点资源的引用地址仍指向旧站点对应的路径，恢复旧站文件相当于临时补全了被引用的资源源，删除后自然出现加载失效。

修复步骤 #

• 第一步：全量替换数据库内的旧域名路径
  • 操作前务必完整备份站点数据库，避免替换错误无法回滚
  • 可直接在后台安装Better Search Replace插件，搜索项填写旧域名完整前缀（例如https://old-domain.com），替换项填写新域名完整前缀（例如https://new-domain.com），勾选所有数据库表后执行替换
  • 有服务器操作权限的用户可直接使用WP-CLI执行替换，命令为：wp search-replace 'https://old-domain.com' 'https://new-domain.com' --all-tables
• 第二步：清理硬编码的旧路径引用
  • 检查当前主题目录下的functions.php、自定义样式表、页面构建器的自定义代码块，删除所有硬编码的旧域名资源路径，统一替换为新域名路径
  • 检查站点根目录下的wp-config.php文件，确认WP_CONTENT_URL、UPLOADS等自定义常量未绑定旧域名
• 第三步：重置站点配置与缓存
  • 进入后台「设置」-「固定链接」页面，无需修改参数直接点击「保存更改」，自动重写站点伪静态规则
  • 清空站点所有缓存：包括后台缓存插件生成的页面缓存、CDN节点缓存、本地浏览器缓存，再访问站点测试资源加载情况
• 第四步：验证迁移资源完整性
  • 确认旧站wp-content/uploads目录下的所有附件资源已经完整拷贝到新站点对应目录，目录权限设置为755，单文件权限设置为644，避免权限不足导致资源无法读取

内容的提问来源于stack exchange，提问作者Siphiwe Mabusela