上传的WEBP动图在网页上只显示第一帧，画面定住不动，这种情况并不少见。不少维护人员的第一反应是文件损坏或上传失败，于是重新上传、改文件名、换浏览器，反复尝试后问题依然存在。多数时候，文件本身并没有坏，真正丢失的是动画信息。要找到原因，可以按顺序核对四个层面。
第一步：确认文件本身是否为动画WEBP
扩展名相同，内容未必相同。静态WEBP和动画WEBP共用同一个后缀，仅看文件名很难分辨。可以查看文件的详细信息，确认是否带有动画标记、帧数是否大于一。如果文件信息显示只有一帧，问题就出在制作或导出环节，网页端怎么调整都不会动。这一步看似简单，却能排除相当一部分误判。
第二步：核对网页端的图片处理链路
文件确认无误后，接着检查图片上传后的处理流程。很多站点会对图片进行缩略图生成、格式转换或压缩，这些环节为了减小体积，常常只保留首帧，把动画部分直接丢弃。上传的原图是动画，但对外提供的地址已经是处理后的静态版本。核对方法是直接访问图片的原始地址，看它是否还会动，再对比页面实际引用的地址，两者不一致就说明中间环节做了转换。
第三步：检查前端展示方式
有些图片组件或标签本身只支持静态图，动画属性没有开启，或者使用了不识别动画的渲染方式，结果就是只显示首帧。需要确认页面引用图片时使用的标签、组件和参数，是否明确允许动画播放。如果组件文档里写明只处理静态图，那就需要更换展示方式，而不是继续在文件上找原因。
第四步：排查浏览器与CDN缓存
即使前面的处理规则已经修正，旧缓存仍可能返回早前转换好的静态版本，让问题看起来没解决。验证时应先清理缓存，再用带参数的地址或强制刷新方式确认返回的是新文件。
核对顺序建议固定为文件、处理链路、前端、缓存，逐层排除，避免同时改动多处导致无法判断哪一步起了作用。
长期维护中，建议把图片处理规则记录下来，明确哪些格式允许动画、经过哪些转换、前端用哪种展示方式，并在上传后做一次实际播放验证。it数运在网站维护类项目中通常会把这类规则写入交付说明，减少后续反复排查。把四层核对变成固定流程，比每次凭经验猜测更省时间。
