WordPress XML导入修改媒体文件名致文章内联图片链接失效

一、FTP+Media Sync方案的正确性 #

这个方案是技术上完全正确且高效的，理由如下：

• 直接绕过WordPress导入器的自动处理逻辑，完整保留旧站点媒体文件的原始文件名和目录结构，从根源上避免文件名被修改
• Media Sync这类插件的核心功能就是将服务器上已存在的物理媒体文件同步到WordPress数据库，生成对应的媒体条目（包括附件ID、元数据、缩略图关联等），确保文章内的原始图片链接能精准匹配到服务器上的文件
• 仅导入帖子XML且不勾选「下载并导入文件附件」选项，彻底避免导入器再次触发媒体下载、缩放或重命名流程

二、其他可行的修复方法 #

如果已经出现了文件名不匹配的问题，除了你的方案外，还有这些可选方法：

• 批量修改数据库链接：直接通过SQL语句批量替换文章内容中的旧文件名。示例语句（需根据实际情况调整表前缀和文件名规则）：

  UPDATE wp_posts SET post_content = REPLACE(post_content, 'image.jpg', 'image-scaled-1.jpg');
  

  注意：操作前必须备份数据库，且要确认重命名的统一规则（比如是否所有文件都加了-scaled-1后缀），避免误替换
• 使用搜索替换类插件：借助专门的数据库搜索替换插件，批量替换数据库中所有旧媒体链接为新的重命名后的链接，这类工具会自动处理序列化数据，比手动写SQL更安全，适合非技术用户
• 提前关闭自动缩放功能：如果还未开始导入，可先在新站点后台关闭「大尺寸图片自动缩放」功能（路径：设置→媒体，取消勾选「缩放大尺寸图片」），再重新使用导入器导入媒体，就能避免导入时触发自动缩放重命名

三、导入器重命名文件的原因 #

出现这种现象主要有两个核心原因：

• 自动缩放机制触发：WordPress 5.3及以上版本默认开启「大尺寸图片自动缩放」功能，当导入的图片宽高超过站点预设的最大尺寸（默认2560px）时，系统会自动生成一张缩放后的图片，并将原始图片重命名为原文件名-scaled.jpg，但导入器在同步文章内的图片链接时可能出现逻辑错误，导致文章仍指向未修改前的原始文件名
• 文件名冲突处理：如果新站点的/wp-content/uploads/目录中已经存在同名文件，WordPress导入器会自动给新导入的文件添加后缀（如-1、-2）来避免冲突，但如果导入前目录为空，这种情况基本可以排除，大概率是自动缩放导致的

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