升级 WooCommerce 11.1 后，旧变体图库没有全部替换进来，是迁移漏数据了吗？

先确认版本变化与迁移边界

WooCommerce 在 10.9 提供原生变体附加图片功能的选择性启用；到 11.1，该功能面向所有商店启用，原有开关被移除。旧 Additional Variation Images 扩展会自动停用，并于 2026 年 9 月 5 日退役。

这意味着升级后的图库来源和维护方式发生变化。不能继续假设旧扩展仍负责把新增图片同步到原生图库。

迁移涉及旧字段 _wc_additional_variation_images 与原生字段 _product_image_gallery。官方明确说明，旧字段会保留，但不再与新字段同步。

决策分支：若升级后仍看到旧字段有图片，应先核对原生图库状态，不能仅凭旧字段存在就断定当前图库缺失或迁移失败。

理解为什么已有图库不会被覆盖

迁移逻辑会保护已有的原生图库数据：当 _product_image_gallery 非空时，不会用旧扩展中的图片覆盖它。这个规则用于避免迁移过程破坏商家已经维护的原生图库。

因此，旧扩展曾保存五张图片，而原生图库已有两张，并不意味着升级一定会自动合并成七张。不能把“没有全部替换”直接解释为任务执行失败。

应分别记录变体 ID、原生图库现有图片和旧字段历史图片，再判断是否存在需要人工审核的差异。

决策分支：原生字段非空，优先按已有值保护规则解释；原生字段为空，则继续检查后台迁移任务是否完成。不要为了强迫迁移而清空生产图库。

虚构练习：两个变体采用不同判断路径

以下为虚构练习（Illustrative exercise），不是实际商店升级或数据库操作记录。

输入 A 是某款背包的颜色变体。升级前旧扩展保存多张图片，而原生 _product_image_gallery 已经包含商家人工维护的图片。升级后没有被旧数据全部替换。按照官方规则，这首先符合非空字段保护行为，应保留原有图库并核对差异。

输入 B 是另一款商品变体，原生图库为空，旧字段存在历史图片，但升级后暂时没有显示。此时不能马上判定丢失，应检查后台迁移任务是否仍在等待或执行。

官方说明迁移每次运行最多处理250个变体，并会重新排队继续处理。变体较多时，不能把第一次任务结束等同于全部迁移完成。这是迁移批次的上限，不是建议导入的商品数量。

决策分支：A 核查保护规则与人工维护内容；B 核查任务进度及完成后的原生图库结果。两者不应采用同一种强制修复操作。

从 Scheduled Actions 验收到团队交接

在 WooCommerce → Status → Scheduled Actions 中检查 woocommerce-db-updates 组，并确认哪些动作与本次图库迁移有关。组内还可能有其他数据库更新，不能把任一失败动作都直接判成图库迁移失败。结合相关任务状态和原生图库内容判断进度，不只看商品页的某一张图片。

迁移完成后，应以当前原生图库作为后续维护对象，旧 _wc_additional_variation_images 仅用于历史对照，不应再被视为持续同步的事实来源。

交接时记录受影响变体、原生字段是否原本非空、后台任务状态及人工核对结论。保留已有数据，不重新激活退役扩展，也不未经审核直接修改生产数据库。

本题重点是迁移保护和后台完成状态，不涉及 CSV 导入字段配置。只有完成字段、任务与前台展示的交叉检查，才能进一步判断是否存在真正需要处理的遗漏。

虚构练习核对表：已有图库保护与后台迁移完成状态

以下示例为虚构练习。另存核对表后填写自己的真实观察；不能将示例当作已完成的验收。

下载核对表（CSV）