完整性校验

大文件上传的完整性校验策略，包括 chunk 级和文件级哈希校验

#type / concept #status / evergreen #tech / dev / frontend #tech / dev / backend

[!info] related notes

所属 MOC: 前端工程化 MOC

前置概念: 秒传机制

并列概念: 前端哈希计算策略

关系笔记: 大文件传输系统设计

一句话定义

完整性校验是在分块上传的每个环节（chunk 上传、chunk 合并后）通过哈希比对确保文件内容未损坏。

层次	校验对象	目的
chunk 级	单个分块	确保每个分块传输正确
文件级	合并后完整文件	确保合并结果与原始文件一致

前端上传每个 chunk 时可携带 chunkHash：

{
  "uploadId": "u_123",
  "chunkIndex": 5,
  "chunkHash": "abc123..."
}

后端收到后计算实际 hash 并比对，不一致则返回错误。

合并完成后，后端计算最终文件 hash：