相机存储卡里那批CR2照片，拖进网页上传框时显示“上传成功”，可点开预览却只有一片空白或者一个裂开的图片图标。同样操作换成手机拍的JPG就一切正常，问题偏偏集中在CR2这一种格式上。CR2是佳能相机的原始数据格式，保存的是传感器捕捉到的原始信息，和JPG这种已经压缩处理完成的成品图走的是完全不同的两条路径。网页端打不开，症结可能藏在文件本身、服务端识别、转换链路或前端展示中的某一环，按顺序分层排查，比一遍遍重传要省事得多。
第一层：先确认文件本身是否完好
把CR2文件下载回本地，核对扩展名和实际内容是否匹配。有些文件在传输或改名过程中被换掉了后缀，看起来是CR2，实际并不是原始格式。再看文件大小，佳能原始格式单张通常在二十兆以上，如果只剩几百KB，很可能是上传中途被截断。请用户提供原始文件的大小和拍摄机型信息，是这一层最省时间的做法。上传组件如果设置了大小上限或超时时间，也要一并确认，避免文件只传了一半就被系统标记为完成。
第二层：检查服务端有没有正确识别格式
原始格式不属于标准图片类型，很多上传接口默认只认JPG、PNG这类常见格式，遇到CR2会当作普通二进制文件存储，类型字段记成未知。这时文件其实已经躺在服务器上，但后续流程根本不知道它是一张照片。核对方法是查看上传后的文件记录，确认类型标识是否正确，以及服务端是否配置了对应的解码库或转换工具。缺少解码能力时，原始格式无法被读取，预览自然无从谈起。
第三层：梳理转换与预览链路
浏览器基本不能直接渲染CR2，常规做法是上传后先转出一张JPG预览图。要确认转换任务是否被触发、是否执行成功、失败时日志写了什么。常见原因是转换程序不支持该机型的新版本原始格式，或者临时目录权限不足、内存超限导致任务中断。日志里如果出现解码错误或超时，问题就定位在这一层，而不是前端。
第四层：排查浏览器与前端展示
打开开发者工具，看前端拿到的是转换后的预览地址，还是原始CR2的文件地址。如果仍是原始地址，浏览器当然打不开。再检查预览图的跨域设置、访问权限和缓存，有时转换已经成功，但地址失效或被缓存了旧结果，页面依旧显示空白。
按顺序执行的核对清单可以这样列：确认文件扩展名与实际内容一致；核对文件大小是否正常、是否完整上传；查看服务端类型识别结果；确认解码库和转换任务状态；读取转换失败日志；检查前端引用的预览地址；排查跨域、权限与缓存。其中文件完整性和原始信息需要用户配合提供，服务端识别、转换链路和前端展示属于网站维护方的职责范围。
日常维护中，上传格式白名单要写清楚支持哪些类型，遇到不支持的格式在上传环节就给出明确提示，而不是让用户等到预览失败才发现问题。转换失败要留下可读的日志和用户可见的说明，方便快速定位。把格式支持、转换状态和失败原因都做成可查的记录，问题出现时按层核对，减少来回猜测，这正是it数运在网站维护中一贯的处理思路。技术有章法，服务有回应，把技术问题说明白，把交付过程做清楚，才是长期稳定的维护方式。
