断点续传必须校验分片MD5而非整文件MD5，因续传仅写入部分数据块，整文件校验无法及时发现单片截断、覆盖或写错；需按固定分片逻辑流式计算并比对每片MD5。
为什么断点续传必须校验分片 MD5 而不是整个文件
因为续传时只写入部分数据块（比如第 3 片 10MB），如果仅校验最终完整文件的 MD5，无法发现中间某一片被截断、覆盖或写错——等全部传完才发现校验失败，前功尽弃。本地分片 MD5 校验本质是「每写完一片，立刻算它的哈希并存下来；下次续传前，先读这片已存在的内容，再算一次 MD5，和上次存的比对」。
关键点在于：必须用同一套分片逻辑（起始偏移 + 长度）+ 同一哈希算法 + 同一读取方式（如二进制、无缓冲），否则 MD5 必然不一致。
- 分片大小建议固定（如
1024 * 1024 * 10字节），避免最后一片长度不一致导致计算逻辑分支增多 - MD5 值建议以十六进制小写字符串形式保存到独立元数据文件（如
file.part.md5），每行对应一片：0: a1b2c3... - 不要用
std::filesystem::file_size()推算当前写了多少片——磁盘缓存、写入中断可能导致文件长度“虚高”
如何用 OpenSSL 的 EVP_MD_CTX 安全计算任意长度文件分片的 MD5
C++ 标准库不提供 MD5，直接调 OpenSSL 是最稳的选择。注意不能把整片读进内存（大文件会爆），必须流式计算；也不能用 EVP_DigestInit 每次都重置上下文——要复用 EVP_MD_CTX 实例做增量更新。
std::string calc_md5_for_slice(const std::string& filepath, uint64_t offset, size_t length) {
FILE* fp = fopen(filepath.c_str(), "rb");
if (!fp) return "";
fseek(fp, offset, SEEK_SET);
<pre class="brush:php;toolbar:false;">unsigned char hash[EVP_MAX_MD_SIZE];
unsigned int hash_len;
EVP_MD_CTX* ctx = EVP_MD_CTX_new();
EVP_DigestInit_ex(ctx, EVP_md5(), nullptr);
std::vector<char> buf(8192);
size_t remain = length;
while (remain > 0 && !feof(fp)) {
size_t to_read = std::min(remain, buf.size());
size_t n = fread(buf.data(), 1, to_read, fp);
if (n == 0) break;
EVP_DigestUpdate(ctx, buf.data(), n);
remain -= n;
}
EVP_DigestFinal_ex(ctx, hash, &hash_len);
EVP_MD_CTX_free(ctx);
fclose(fp);
std::stringstream ss;
for (unsigned int i = 0; i <p>}</p></char>
- 务必检查
fseek()返回值，某些文件系统（如 FAT32）对超大 offset 支持差，可能静默失败 - 不要用
std::ifstream默认构造（文本模式），它在 Windows 下会把\r\n当作单个\n处理，破坏二进制一致性 - OpenSSL 1.1.1+ 要求显式调用
EVP_MD_CTX_new()和EVP_MD_CTX_free()，漏掉会导致内存泄漏
分片校验失败时怎么定位是哪一片出问题
常见错误现象：calc_md5_for_slice() 返回空字符串、MD5 字符串长度不是 32、两次计算结果不一致。优先排查三类问题：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 文件被其他进程修改或截断：校验前加
fstat()检查st_size是否 ≥offset + length，否则直接报错"slice overflow" - 分片索引错位：比如服务端按 0-based 分片，客户端误用 1-based 索引去读第 2 片，实际读了第 3 片内容
- MD5 存储/加载时编码污染：元数据文件用 UTF-8 BOM 或换行符混用（
\r\nvs\n），导致解析出的 MD5 字符串多出不可见字符
实战建议：在校验循环里打印每片的 offset、length、期望 MD5 和实际 MD5，用 diff -u 对比输出日志，一眼看出差异位置。
本地分片 MD5 文件怎么设计才抗删改、易维护
不要把 MD5 值硬编码进程序或拼在文件名里（如 part_001_a1b2c3...dat）。正确做法是单独存一个轻量元数据文件，格式为纯文本键值对，带校验头防止误编辑。
示例 upload_abc123.meta 内容：
# meta v1 # total_size: 104857600 # chunk_size: 10485760 0: 9e107d9d372bb6826bd81d3542a419d6 1: 8f14e45fceea167a5a36dedd4bea2543 2: d41d8cd98f00b204e9800998ecf8427e ...
- 首行加
# meta v1标识版本，后续可扩展字段（如支持 SHA256 切换） - 用
#行注释记录关键参数，避免代码和元数据分片逻辑脱节 - 写入元数据文件时，先写临时文件（如
.upload_abc123.meta.tmp），fsync()后再rename()原子替换，防止断电导致元数据损坏
真正容易被忽略的是：校验阶段必须同时验证元数据文件自身完整性——哪怕只有一片 MD5 错了，也要拒绝整个续传流程，否则可能把错误扩散到后续所有分片。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
