视频上传后能正常播放，列表封面却始终是黑屏，这种情况并不一定意味着文件损坏。很多人遇到这个问题会反复重传，但结果往往一样。既然视频本身能播放，说明文件大概率是完整的，问题更可能出在封面图这条独立链路上。封面和视频在系统里通常走的是两套处理流程，任何一环断了，前端看到的都是黑屏。下面按处理顺序，从四个层面逐步核对。
第一层，先看封面帧有没有被真正抽出来并保存下来。
视频上传后，服务端一般会调用工具抽取首帧或指定时间点的画面，生成一张图片作为封面。这一步要确认三件事：抽取任务是否真的执行了，执行后有没有生成图片文件，生成的文件大小是否正常。如果抽取任务因为超时、进程被中断或依赖工具缺失而没有跑完，封面文件可能根本不存在，或者是一个零字节的空文件。前端拿不到有效图片，自然显示黑屏。可以先看上传目录里有没有对应的封面文件，再确认文件大小是否大于零。
第二层，检查转码环节首帧时间点和关键帧间隔是否匹配。
有些视频开头是黑场或渐入画面，抽取首帧得到的本来就是一张黑色图片，这不是故障，而是素材特性。更常见的情况是，转码时关键帧间隔设置过大，抽取工具定位到的时间点落在两个关键帧之间，只能向前取到最近的关键帧，而那个位置恰好是黑场。核对时要确认抽取时间点是否固定为零秒，是否可以改为取第一秒或第二秒，同时检查转码参数里的关键帧间隔是否合理。把抽取时间点稍微后移，往往就能避开黑场。
第三层，核对存储与访问环节封面文件路径、权限与缓存是否一致。
封面生成后要写入存储，前端再通过地址访问。这里容易出现三类问题：一是路径拼接错误，数据库里记录的封面地址和实际存储位置不一致；二是权限配置不当，封面文件没有对外开放读取权限，请求返回的是错误状态；三是缓存问题，旧的黑屏封面被缓存住，新封面生成后前端仍然读到旧内容。核对时可以直接在浏览器里打开封面地址，看返回的是图片、错误页还是空白，再对比数据库记录与实际文件路径是否一致。
第四层，确认前端展示环节占位图、懒加载与比例裁剪是否覆盖了封面。
有时候封面文件完全正常，但前端展示逻辑把它盖住了。比如占位图层级过高，一直压在封面上方；懒加载触发条件没满足，图片始终没有真正加载；或者容器比例和封面比例差异过大，裁剪后只剩边缘的黑色区域。核对时可以临时去掉占位图和懒加载，直接渲染封面地址，看是否能正常显示，以此判断问题出在数据还是展示层。
按顺序执行的核对清单可以这样安排：先确认封面文件是否存在且大小正常，再确认抽取时间点是否避开黑场，接着确认封面地址能否直接访问，最后确认前端展示逻辑是否遮挡封面。其中抽取任务是否执行、转码参数是否生效、访问请求返回什么状态，这三类信息通常需要结合服务端日志判断。日志里能看到任务调度记录、转码工具输出和请求响应码，比单纯看前端表现更直接。it数运在处理这类网站维护问题时，通常也是按这条链路逐层排查，先把封面文件本身确认清楚，再往展示层找原因，避免一上来就重传视频。
