做网站维护时，后台传了一张会动的GIF，网页上播放正常，可一旦放进邮件里发给客户，对方收到的要么是一张静止的首帧图，要么干脆是一块空白。很多人第一反应是图片坏了，重新上传、重新发送，结果依旧。问题往往不在GIF本身，而在从文件到客户端这条链路上，有几层处理逻辑和网页端完全不同。
先核对文件本身。用图片查看工具打开原始GIF，确认它确实是多帧动画，而不是一张改了扩展名的静态图。接着看帧延迟和循环次数，有些压缩工具、在线转换工具或图片处理脚本会把循环次数改写为只播放一次，甚至把多帧合并成单帧。文件在本地打开时如果只闪一下就停，说明问题出在文件生成环节，与邮件无关。这一步最容易被跳过，却最能快速排除误判。
再核对引用方式。邮件里的图片通常有三种形态：外链图片、CID内嵌和直接附件。外链方式下，客户端需要主动联网拉取图片，部分客户端默认不加载远程图片，GIF自然不显示；CID内嵌是把图片作为邮件的一部分打包发送，兼容性相对稳定，但部分客户端会把内嵌图当静态资源处理；直接附件则取决于收件人是否愿意点开。维护时要先确认邮件模板用的是哪一种，再判断现象是否与发送形态吻合。
接着核对客户端支持。不同邮件客户端对GIF的处理差异很大，有的默认播放动画，有的需要用户手动允许加载图片，有的会对超过一定尺寸的图片做缩放或转静态处理。同一封邮件在桌面客户端、网页邮箱和手机端表现可能完全不同。排查时不要只测一个客户端，至少覆盖两类以上，并记录每类的表现，才能判断是普遍问题还是个别环境问题。
最后核对服务器与缓存。图片经过CDN、图片代理或邮件营销平台时，可能被自动压缩、格式转换或缓存旧版本。曾经正常的GIF突然不动，很可能是缓存里还留着上一版静态图。可以临时换一个文件名或加一个查询参数再测，观察现象是否变化，以此判断缓存是否参与其中。
可执行的排查顺序是：先在本地用看图工具验证动画完整，再换两到三个客户端测试同一封邮件，最后回到发送方式核对外链、内嵌还是附件。三步走完，多数问题能定位到具体一层。
