MD5哈希校验签名
要把“文件完整性”这件事做好，其实就两步：下载/传输后算哈希，和来源方公布的哈希对比；对得上，证明内容没被改。多数项目里，MD5 仍然是“够用且好用”的选择：实现简单、速度快、生态支持好。它并不是安全签名算法，但在“传完没传坏”“两个文件是不是相同”这类需求上，MD5效率极高。
工作里常见四个场景：
- 大文件下载校验：镜像、安装包、素材资源；
- API层面幂等或去重：同内容不重复写入；
- 静态资源命名：文件名带上MD5做缓存更新；
- 简易签名：低风险场景快速校验（注意风控边界）。
把它用顺手，有几条经验：
- 文件流式计算，别一次性把大文件读进内存；
- 文本计算要明确字符集，统一 UTF-8；
- 后端统一输出小写hex，前端工具显示也跟着统一；
- 结果对不上，先排编码与换行符差异，再排传输是否被处理（压缩/重编码）。
很多人遇到“本地MD5和服务器MD5不一样”，结果排查一天，最后发现：本地是Windows格式换行 \r\n，服务端是 \n；或者上传时被网关做了内容改写。定位这种问题，务必用十六进制查看原始字节，别只看文本渲染出来的样子。
与安全相关的误区必须澄清：
- MD5 不是抗碰撞安全的签名算法，不能单独用于对抗恶意篡改；
- 需要抗抵赖与完整性保护的签名场景，请选 HMAC-SHA256 及同类方案；
- MD5 在非对抗场景（下载校验、去重）完全够用。工程里不要过度设计，但更不要拿错工具。
工程落地清单：
- 下载页显示文件大小与MD5，最好再给SHA256；
- API上传走分片时，每片与整体都给MD5，便于断点续传与排障；
- 静态资源构建产物文件名带内容哈希，缓存失效自然发生；
- 数据去重：内容MD5 + 大小 + 类型，多维组合更稳健。
在我们的网站，你可以直接使用“MD5计算器”在线计算文本哈希，同时显示 HEX 与 Base64 两种表示。字符集、大小写、实时计算、错误提示都开箱可用。调试时非常方便：贴入一段文本，就能直接得出结果；也可以把另一端给的哈希值黏过来对比。对于脚本同学，在线工具是个“对照物”，能快速分辨到底是你库的用法不对，还是数据被改了。
如果你在接口层要做一个“轻量签名”，建议直接升级到 HMAC-SHA256。MD5 应留在非对抗场景。例如：
- 对象存储回调里带一个
content-md5，服务端二次校验； - 导入去重：同一个CSV的内容MD5一致，不做重复导入；
- 日志采集：内容MD5做幂等，防止重复写入。
最后再给一份排障清单，够你大部分时候“十分钟定位”：
- 文本类：统一 UTF-8，无BOM；
- 行尾：统一
\n； - 传输：关闭“自动转码/压缩”影响原始内容的中间件；
- 结果：统一小写十六进制显示；
- 工具：在线工具与脚本工具结果需一致，差异就地排查。
把这些细则做好，MD5 就成为你工程里的“小扳手”——不花哨，但每次都好用。
相关在线工具：
- 立即使用 MD5 计算器