摄影爱好者把一张CR2相机原片上传到网站，进度条走完，缩略图位置却是一片纯黑。文件确实传上去了，大小也对，可预览就是不出画面。这类问题在网站维护中并不少见，原因往往不在一个点上，需要按层次逐步核对，才能判断问题出在文件、解码、转码还是展示环节。
先核对文件本身是否可读。查看上传记录中的文件大小与本地原文件是否一致，明显偏小通常意味着传输中断或上传被截断。把原文件下载回来，用本地看图工具打开，能正常显示说明文件完整，打不开则可能是存储过程出错或文件在源头就已损坏。这一步的意义在于把文件损坏和网页端处理失败区分开，避免在文件本身有问题时反复排查代码。
再核对网页端的解码能力。浏览器对相机原始格式的支持十分有限，多数浏览器并不能直接渲染CR2。需要确认上传组件是否设置了格式白名单，是否对这类文件安排了转码流程。如果页面是直接把原始文件地址交给前端渲染，预览全黑几乎是必然结果。判断方法是查看预览请求返回的内容类型，是原始文件还是已经处理过的图片。
接着核对转码与缩略图流程。相机原片通常需要服务端转码后生成可展示的缩略图。检查转码任务是否执行成功，查看任务日志中的错误码和耗时，确认缩略图生成参数与色彩配置是否合理。有些流程能生成图片，但色彩空间处理不当，输出结果偏暗甚至接近全黑，同样表现为预览失败。
最后核对展示与缓存。确认预览地址是否指向已生成的缩略图，而不是原始文件路径。排查缓存是否让旧图覆盖了新结果，必要时清理缓存后重新加载。同时检查图片访问权限和跨域配置，加载被拦截时页面同样只显示黑块。
把四层串起来，就形成一条可复用的核对顺序：先验文件完整性，再查前端解码方式，接着看服务端转码结果，最后确认展示链路。对相机原片这类特殊格式，统一走服务端转码再输出缩略图，比让浏览器直接处理更稳妥。it数运在网站维护实践中也遵循这一思路，把处理过程记录清楚，保留原始文件，每步结果可追溯，问题定位会快很多。
