HMAC验证文件完整性只需三步：读取二进制文件、流式计算HMAC、比对Base64编码签名；须注意密钥安全加载、缓冲区分块读取、严格校验路径与编码一致性。
怎么用 HMAC 验证文件没被篡改
核心就三步：读文件、算 HMAC、比对签名。别碰 OpenSSL 的 EVP 接口全家桶，用 HMAC_CTX_new + HMAC_Update 就够用，但得注意输入数据是原始字节流，不是字符串——文件必须以 std::ios::binary 打开，否则 Windows 下换行符被悄悄替换，HMAC 就对不上。
- 密钥不能硬编码在代码里，至少从环境变量或配置文件读取，比如
getenv("FILE_SIG_KEY") - 哈希算法选
SHA256而非MD5或SHA1，后者已被证实不安全 - 签名本身建议 Base64 编码后存储（比如存在同名
.sig文件里），避免二进制签名写入文本文件时被截断或损坏
HMAC 计算时为什么文件要分块读，不能一次 read 到内存
大文件（比如 >500MB）直接 std::vector<char>(file_size)</char> 容易触发 OOM，尤其在嵌入式或容器环境下。OpenSSL 的 HMAC_Update 支持流式计算，只要每次传入连续内存块，内部会自动维护状态。
- 推荐缓冲区大小设为
8192（8KB），太小增加系统调用开销，太大无实际收益 - 务必检查
read()返回值是否为 0（EOF）或 -1（错误），忽略它会导致最后几字节没参与计算 - 别用
std::ifstream::rdbuf()->sgetn()，它可能因 locale 设置意外做字符转换；坚持用read(reinterpret_cast<char>(&buf), size)</char>
验证失败时常见错误现象和排查点
最常遇到的是 “签名正确但验证失败”，基本不是算法问题，而是数据不一致：
- 签名文件末尾多了换行符（
\n），Base64 解码后多一个字节 → 比对前先用strcspn(sig_str, "\r\n")截断 - 文件路径用了相对路径，但运行时工作目录变了，实际读的是旧文件 → 验证前加一句
if (!fs::exists(filepath)) { /* 报错 */ } - 密钥在签名和验证两端不一致，比如一端用了
std::string(key).c_str()，另一端用了key.data()，而 key 是空字符串 → 统一用key.c_str()和key.length() - Windows 下用记事本保存密钥文件，BOM 头被当成了密钥开头 → 密钥读取后用
if (key.starts_with("\xEF\xBB\xBF")) key.erase(0, 3);
C++17 起能用 std::filesystem 但别依赖它做原子性保证
std::filesystem::last_write_time 或 file_size 不能替代 HMAC —— 时间戳可被修改，大小相同不代表内容相同。但可以辅助快速拒绝明显过期的文件：
立即学习“C++免费学习笔记（深入）”；
- 签名文件比原文件还早？直接跳过验证，省 CPU
- 用
std::filesystem::status(filepath).permissions()检查是否只读，防止运行中被覆盖（仅作提示，不阻断逻辑） - 别用
std::filesystem::copy_file复制带签名的文件，默认不复制扩展属性，Linux 下xattr存的签名会丢
真正难的从来不是算 HMAC，而是确保参与计算的每个字节都来自你“以为”的那个文件——路径解析、编码、权限、挂载选项、甚至 NFS 缓存策略，都可能让 read() 返回意料之外的数据。
