运营在媒体库用 Replace Media 换了主视觉，列表里是大图新图，文章卡片仍是旧图。右键看地址，请求的 -300x200.jpg 修改时间还是三个月前。日志里能对上时间点，这种反而好排。
替换功能只覆盖了原始文件，sizes 里的各档缩略图没有重新生成，元数据里的尺寸和文件名也没变。前台按固定尺寸取图，拿到的还是磁盘上那份旧缩略图。这一点先确认清楚，后面就不用反复试。
wp media regenerate 4521 --yes # 只重建指定尺寸 wp media regenerate 4521 --image_size=thumbnail --yes
「替换附件缩略图未更新」排查到最后往往是很小的一处差异，前面那些复杂猜测可以先放一放。偶发问题先统计频率，一小时几次和一天一次，查法完全不同。
改完顺手把文档补一句，省得下次自己重新推一遍。
处理上按这个顺序：替换后立刻用 wp media regenerate 指定这个附件 ID 重跑；新图比例不同时先删掉旧 sizes 记录再生成 避免沿用旧宽高；给替换操作挂个钩子自动触发重生成 别靠人工记得。
结果对不对很好判断，文章卡片里的图换成新版本，-300x200 文件的修改时间变成今天。