C++标准库未提供HMAC-MD5，因其既不包含MD5实现（C++23仅提供无密钥的std::md5_hasher），也不支持带密钥的HMAC构造；MD5本身已不安全，标准库倾向避免推广弱算法，故推荐使用OpenSSL等第三方库实现。
为什么标准库没有 HMAC-MD5？
C++ 标准库（包括 <random>、<hash>）根本不提供任何 HMAC 或 MD5 实现。MD5 本身已被认为不安全，而 HMAC-MD5 是一种带密钥的哈希构造，需要手动实现或依赖第三方库。别试图用 std::hash 或 std::md5（后者 C++23 也只提供无密钥的 std::md5_hasher，且不支持密钥输入）——它们都不满足 HMAC 要求。
用 OpenSSL 实现 HMAC_MD5 的最小可行代码
OpenSSL 是最常用、跨平台、经过充分验证的选择。注意：必须链接 -lcrypto，且版本 ≥ 1.0.2（推荐 1.1.1 或 3.x）。关键不是“调用一个函数”，而是正确使用 HMAC() 接口：
unsigned char result[EVP_MAX_MD_SIZE];
unsigned int result_len;
const unsigned char* key = reinterpret_cast<const unsigned char*>("my_secret_key");
const unsigned char* data = reinterpret_cast<const unsigned char*>("hello world");
<p>// 注意：第三个参数是 key 长度，不是 strlen() —— 如果 key 含 \0 必须显式传长度
unsigned char* mac = HMAC(EVP_md5(), key, 6, data, 11, result, &result_len);</p><p>// result 中存放 result_len 字节的二进制结果（16 字节）
// 如需 hex 输出，自行转换（例如用 sprintf 或 std::format）-
EVP_md5()返回 MD5 的 EVP_MD 指针，不能用EVP_sha256()替代——HMAC 算法和底层哈希强绑定 - key 长度传错会导致结果完全错误（比如用
strlen(key)处理二进制密钥会截断） -
HMAC()返回值是result地址，但实际结果存入result缓冲区；返回值仅作校验，失败时为nullptr
自己实现 HMAC-MD5 的风险点
除非你有密码学审计需求，否则不要手写 HMAC。常见翻车点包括：
- 密钥填充逻辑错误：HMAC 要求若 key > block_size（MD5 是 64 字节），先哈希 key 再填充；若 ≤，直接补零到 64 字节——漏掉任一路径都会导致结果与 OpenSSL 不一致
- 内层/外层 XOR 常量用错：
0x36和0x5c必须按 RFC 2104 严格使用，顺序颠倒或字节序搞错就全废 - MD5 自身实现未处理小端对齐、padding 规则（如消息长度是 bit 数，不是 byte 数）——已有大量已知 bug 的“轻量级 MD5”实现不可信
替代方案：用 libsodium 或现代 C++ 封装
如果不想依赖 OpenSSL（比如静态链接冲突、许可限制），libsodium 提供更简洁的 API，但注意它默认不暴露 MD5（因不推荐），需自行启用或改用 crypto_auth_hmacsha256。另一个务实选择是用 boost::uuid::detail::md5 + 手动 HMAC 逻辑——但 boost 的 md5 是内部实现，无公开 ABI 保证，且同样不提供 HMAC 封装。
立即学习“C++免费学习笔记（深入）”；
真正省心的做法是接受 OpenSSL 依赖，并封装一层：
std::string hmac_md5(const std::string& key, const std::string& data) {
std::vector<unsigned char> out(EVP_MAX_MD_SIZE);
unsigned int out_len;
auto* res = HMAC(EVP_md5(),
key.data(), static_cast<int>(key.size()),
reinterpret_cast<const unsigned char*>(data.data()), static_cast<int>(data.size()),
out.data(), &out_len);
if (!res) return {};
return std::string(reinterpret_cast<char*>(out.data()), out_len);
}密钥长度、数据生命周期、OpenSSL 初始化（OPENSSL_init_crypto() 在 3.x 中推荐显式调用）这些细节，比算法本身更容易出问题。
