上传到网站的GIF动图打开后只播放一遍就停在最后一帧，刷新页面才重新动一次，这是不少网站维护人员都遇到过的情况。很多人的第一反应是文件坏了，于是重新制作、重新上传，结果问题依旧。实际上，GIF只播一次并不一定是素材损坏，更常见的原因藏在循环参数、解码环境和页面处理这三个环节里。排查时按顺序走，比反复换图更省时间。
第一步：先核对文件本身
GIF格式里有一个循环次数标记，用来告诉播放器这段动画要重复几遍。如果这个标记的值为1，播放器就只播一次；如果制作工具导出时默认不循环，也会出现同样的表现。检查方法是把原文件下载到本地，用系统自带的图片查看器或常见播放器打开，观察它是否循环。若本地也只播一次，问题基本锁定在源文件，需要回到制作环节把循环次数设为无限或所需次数。同时留意帧数和帧延迟，帧延迟设置过短或过长，在某些环境下会被合并或跳过，看起来也像“停住”。
第二步：再核对浏览器与解码路径
不同浏览器对GIF循环参数的处理并不完全一致，有的严格读取文件头，有的在特定版本下会忽略某些标记。更值得注意的中间环节是图片处理服务：如果网站对上传图片做了压缩、转码、生成缩略图，或者经过CDN缓存优化，处理程序可能重新写入了GIF文件头，把循环次数改成了1。核对办法是直接访问图片的原始地址，对比上传前的文件和服务器上实际返回的文件，看文件大小和循环标记是否一致。若不一致，就要检查图片处理配置，确认转码环节是否保留了动画参数。
第三步：核对页面代码
图片本身正常，但页面上的表现异常，常见于三种情况：脚本在图片加载后替换了图片地址，替换后的版本不带循环参数；懒加载组件在图片进入视口时重新赋值，导致动画重新开始却只执行一轮；用画布重绘方式展示图片时，只绘制了首帧或某一帧。排查时可以临时禁用页面脚本，直接打开图片地址观察，若此时循环正常，说明问题出在页面逻辑，需要检查图片元素的替换、懒加载和画布渲染代码。
逐层排查清单
把以上环节串起来，可以得到一份逐层排查清单：第一步，本地打开原文件确认是否循环；第二步，查看GIF文件头的循环次数标记和帧延迟；第三步，对比服务器返回文件与上传文件是否一致；第四步，检查图片压缩、转码和CDN配置；第五步，禁用脚本后直接访问图片地址；第六步，检查懒加载、图片替换和画布重绘逻辑。每一步都留下记录，包括文件哈希、返回头信息和复现步骤，后续再遇到类似反馈就能快速定位。it数运在网站维护中处理这类问题时，习惯把源文件状态、传输链路和页面行为分开记录，避免把不同层的原因混在一起。
判断顺序可以概括为一句话：先确认源文件，再确认传输链路，最后确认页面行为。按这个顺序排查，多数“只播一次”的问题都能在换素材之前找到原因，也避免了对正常文件的反复重做。
