Gaaai 图片修复插件：WordPress媒体库与正文图片路径批量修复工具

Gaaai Image Repair图片修复工具（Gaaai Image Repair）是一款专为 WordPress 网站维护场景开发的独立图片地址修复插件，适合用于批量修复文章正文中图片地址失效、图片文件名变化、WebP 转换后旧图片路径错误、媒体库地址与正文图片地址不一致等问题。

插件会根据文章正文图片标签中的 wp-image-ID，自动读取 WordPress 媒体库中该附件当前真实地址，并将正文中的图片 src、懒加载地址以及外层图片链接同步修复为正确地址，帮助站长快速恢复文章图片显示。

插件适合解决什么问题？

很多 WordPress 网站在长期运营过程中，可能会遇到以下情况：

• 图片转换 WebP 后，正文图片仍然指向旧地址。
• 媒体库图片文件名或路径变化后，文章正文图片无法正常显示。
• 批量处理缩略图或图片优化后，旧的 srcset、sizes 仍然加载错误小图。
• 文章正文图片地址与媒体库真实附件地址不一致。
• 网站迁移、图片整理、图片压缩后，需要批量修复历史文章图片。

Gaaai 图片修复工具以“附件 ID”为核心修复依据，能够更准确地把正文图片恢复到媒体库当前真实地址，减少手动排查成本，提高网站维护效率。

如果你的网站出现图片不显示、图片地址错乱、WebP 转换后正文仍加载旧图片等问题，这款插件可以帮助你快速完成批量修复。

核心功能

插件截图

插件特色

1. 不按文件名猜测，修复更准确

插件不会根据图片文件名进行模糊匹配，而是根据正文图片标签中的 wp-image-ID 获取媒体库附件地址。只要正文图片保留了 WordPress 的 wp-image-ID，插件就可以更准确地找到对应媒体库图片，降低误替换风险。

2. 适合 WebP 转换后的图片地址修复

如果你的网站做过图片 WebP 转换、图片压缩、媒体库整理或批量替换，正文中可能仍然保留旧图片地址。使用 Gaaai 图片修复工具，可以快速将正文图片地址修复为媒体库当前地址。

3. 同时处理普通图片与懒加载图片

插件不仅修复 img src，还支持 data-src、data-original、data-lazy-src 等懒加载字段，适配常见主题、优化插件和图片懒加载方案。

4. 自动移除旧响应式图片属性

部分图片虽然 src 已修复，但浏览器可能仍然通过 srcset 加载旧的小尺寸图片。插件会自动清理旧 srcset、data-srcset、sizes，减少图片继续加载错误地址的问题。

5. 独立轻量，不依赖 GaaaiPress

Gaaai 图片修复工具是独立快速修复工具，不依赖 GaaaiPress 或其他插件。适合在网站维护、图片异常排查、历史内容修复时单独安装使用。

使用场景

• 网站图片地址失效，需要批量修复正文图片。
• 网站迁移后，文章图片显示异常。
• 图片 WebP 转换后，正文图片仍加载旧地址。
• 媒体库图片地址已更新，但文章正文仍指向旧链接。
• 历史文章较多，不适合手动逐篇修改图片地址。
• 站长需要一个简单、直接、可控的图片修复工具。

使用方法

1. 安装并启用 Gaaai 图片修复工具。
2. 进入 WordPress 后台的“Gaaai 图片修复”菜单。
3. 建议先备份数据库。
4. 设置每批扫描文章数量，默认每批 500 篇。
5. 点击“开始修复”，插件会自动批量扫描并修复图片地址。
6. 如需重新扫描全部文章，可勾选“从头开始”。
7. 修复完成后，可查看累计扫描文章、更新文章、修复图片和跳过图片数量。

注意事项

• 执行前建议先备份数据库。
• 插件会直接更新文章正文内容，不创建文章修订版本。
• 插件只处理正文中带 wp-image-ID 的图片，不处理没有附件 ID 的普通外链图片。
• 如果附件已经从媒体库删除，插件会跳过该图片，不会强行替换。
• 建议先在测试站或少量文章中验证效果，再用于大型网站批量修复。