WP Migrate DB Pro迁移媒体至预发布站点后路径错误求助

DevOps 小满

2026-5-19

解决WP Migrate DB Pro迁移媒体后路径不匹配的问题

嘿，我之前也遇到过WP Migrate DB Pro搭配Media Files Add-on迁移媒体时路径不匹配的坑，给你几个实用的解决方向：

检查并配置迁移的路径替换规则
WP Migrate DB Pro的核心能力之一就是处理数据库中的路径和URL替换，大概率是你迁移时没设置正确的替换规则。进入迁移设置的「Find & Replace」板块，添加两组替换规则：
1. 查找原站点的服务器路径：/wordpress/wp-content/uploads/，替换为预发布站点的实际路径：/app/uploads/
2. 查找原站点的媒体URL（比如https://your-prod-site.com/wordpress/wp-content/uploads/），替换为预发布站点的对应URL：https://your-staging-site.com/app/uploads/
  确保这两组规则覆盖了数据库中所有引用旧路径的位置，包括文章内容、自定义字段、小工具设置里的图片链接。
验证Media Files Add-on的单独配置
有些版本的Media Files Add-on会有独立的媒体存储路径设置，你可以去插件的设置页面看看有没有「目标上传路径」之类的选项，把它改成预发布站点的/app/uploads/，之后重新触发媒体迁移操作。
手动执行数据库路径替换（应急方案）
如果上面的方法都没生效，可以用WP CLI或者phpMyAdmin手动替换数据库里的旧路径。用WP CLI的话，执行这条命令（记得先备份数据库！）：
```
wp search-replace '/wordpress/wp-content/uploads/' '/app/uploads/' --skip-columns=guid
```
加上--skip-columns=guid是为了避免修改WordPress的guid字段，防止影响RSS订阅等功能。
检查预发布站点的wp-config.php配置
看看预发布站点的wp-config.php里有没有自定义上传路径的代码，比如：
```
define('UPLOADS', 'app/uploads');
define('WP_CONTENT_DIR', dirname(__FILE__) . '/app');
```
如果有这类自定义配置，WP Migrate DB Pro可能没自动识别到，这时候手动配置替换规则就尤为重要。