具体表现
换了主题后商品列表的图片全是占位图，详情页大图却正常。
先判断哪一层出错
新主题注册了新的图片尺寸，旧图没有对应尺寸的裁切文件。判断时先分清是 WooCommerce 缩略图 本身的配置问题，还是上游调用、运行环境带进来的差异；前者改配置就能收口，后者要沿着请求链路一层层往上找，处理顺序不能颠倒。先在出问题的机器上复现一次，把报错原文和发生时间记下来，再对着日志定位。
操作步骤
- 确认主题声明的尺寸
- 用重新生成缩略图工具补全
- 清理缓存后复查
对应的命令或配置片段如下，可直接复制：
# 安装 Regenerate Thumbnails 后 # 工具 -> 重新生成缩略图 wp media regenerate --yes
测试环境复现不了时，先对比两边的版本号和配置文件，差异往往就在被忽略的那几行里。如果同一现象隔一段时间又出现，多半是某个定时任务或重启流程把配置覆盖回去了，顺手查一遍启动脚本。
收尾检查
列表页商品图正常显示，尺寸与主题一致。