用户上传了一张AVIF格式的动图，本地看图软件里播放流畅，放到网站上却停住不动，只剩一帧静止画面。这跟“图片完全不显示”是两码事，得拆开来看。完全不显示，多半是路径写错、权限被拦或者格式压根没被识别；而第一帧能出来、后面不播，说明浏览器已经认出了这是一张图，卡住的地方在动图属性和播放环节。排查顺序应该从文件本身往外推，再到网页端环境。
先确认文件到底是不是动图序列。AVIF基于AV1编码，静态图和动图共用一个扩展名，光看文件名根本分不出来。把文件拖进能查看帧信息的工具里，看帧数是否大于一，循环次数参数有没有被写成只播一次。有些导出工具默认输出单帧，或者把循环次数设成1，网页端自然就停在一帧上。同时留意文件大小和帧数的比例，帧数很多但体积小得反常，往往说明导出时帧被合并或丢掉了。
再核对网页端的解码能力和兜底策略。AVIF动图在不同浏览器、不同版本之间的支持程度差别明显，有些环境能解静态AVIF，却播不了动画序列。维护时别只看自己常用的浏览器，应该在目标用户可能用到的几个主流环境里分别打开同一页面。如果确认是解码支持不足，就得准备兜底方案，比如提供同内容的WebP动图或视频格式作为替代，通过页面判断能力后自动切换，而不是把一张AVIF直接丢上去就算完事。
接着核对尺寸、帧延迟和渲染限制。动图尺寸过大、单帧延迟设得过短，都会让浏览器在渲染时选择降级处理，表现就是停在首帧或者播放卡顿。检查每帧的延迟数值是否合理，总像素有没有超出页面容器的承载范围。另外注意页面上的CSS是否对图片做了固定高度裁切，或者设置了影响动画的属性，这些样式层面的干预同样会让动图看起来不动。逐项排除后，问题一般能收敛到文件参数或运行环境两者之一。
上传前的自检可以按这份清单走：确认帧数大于一，确认循环参数为持续播放，确认在至少两个目标浏览器里实际播放过，确认提供了替代格式，确认页面样式没有干扰动画渲染。在网站维护流程中把格式兼容检查放在上传环节之前，由维护人员先验证动图属性再进入页面配置，能减少上线后反复排查的时间。把这几层核对固定成习惯，多数“动图不动”的问题在上传阶段就能被发现。
