AES加密配置结构体时，密钥须从安全源获取、IV每次随机生成并随密文保存；仅对POD结构体直接序列化，含std::string等需手动序列化；.enc文件须定义固定头包含magic、cipher_id、IV和tag长度；GCM模式必须保存认证标签；缓冲区需预留足够空间，错误须用ERR_print_errors_fp排查。
用 AES 加密配置结构体前，先确认密钥和 IV 怎么来
硬编码密钥或固定 IV 是最常见也最危险的做法——加密形同虚设。AES 的安全性完全依赖密钥保密性和 IV 的不可预测性。生产环境必须从安全来源获取：比如系统密钥库（Windows DPAPI、macOS Keychain）、硬件模块（TPM），或至少由用户口令派生（用 PBKDF2 或 scrypt）。IV 每次加密都得重新生成，且必须和密文一起保存（通常前置 16 字节），不能复用。
-
IV必须是随机的，用std::random_device+std::uniform_int_distribution填充，别用time(0) - 密钥长度要匹配算法：AES-128 要 16 字节，AES-256 要 32 字节；少一字节都会导致
EVP_EncryptInit_ex返回失败 - OpenSSL 1.1.1+ 推荐用
EVP_AEAD接口，比老式EVP_Encrypt*更难误用
序列化配置数据时，避免直接 memcpy 结构体到内存
C++ 结构体有对齐填充、虚函数表指针、非 POD 类型成员（如 std::string、std::vector），直接二进制 dump 会写入垃圾内存或指针地址，解密后无法还原。
- 只对纯 POD 结构体（如仅含
int、double、char[32]）做reinterpret_cast<const uint8_t*>(&cfg) - 含
std::string的配置，必须手动序列化：先写长度（uint32_t），再写内容字节 - 推荐用
flatbuffers或protobuf生成二进制 schema，比手写序列化更可靠 - 加密前务必计算真实有效字节数，别把整个
sizeof(cfg)当作明文字节数传给 OpenSSL
写 .enc 文件时，文件头格式决定后续能否正确解密
.enc 不是标准格式，你得自己定义最小可用头。否则几年后连自己都读不懂——比如不知道用的是 AES-128-CBC 还是 AES-256-GCM，IV 在哪，认证标签多长。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 建议固定 32 字节头：
uint8_t magic[4] = {'E','N','C','1'}+uint8_t cipher_id = 1（1=AES-256-GCM）+uint8_t iv_len = 12+uint8_t tag_len = 16+uint8_t iv[12]+uint8_t reserved[7] - OpenSSL 的 GCM 模式必须保存认证标签（
tag），它通常追加在密文末尾，长度由EVP_CIPHER_CTX_ctrl(ctx, EVP_CTRL_GCM_GET_TAG, ...)获取 - 不要省略头校验：解密前先检查
magic和cipher_id，不匹配就立刻拒绝，避免用错算法解密出乱码还继续处理
用 OpenSSL 加密时，EVP_EncryptFinal_ex 失败往往意味着缓冲区太小
很多人卡在这一步：加密函数返回 0，但没查错误码，直接以为“加密失败”，其实是输出缓冲区没预留够空间。AES-CBC 最大膨胀是加一个完整块（16 字节），GCM 还要额外加 tag 长度（通常 16 字节）。
立即学习“C++免费学习笔记（深入）”；
- 输出缓冲区大小 = 明文字节数 + 16（CBC）或 + 16（GCM 密文）+ tag_len（GCM 额外）
- 调用
EVP_EncryptFinal_ex前，必须确保目标缓冲区还有足够空间，否则会写越界或返回失败 - 错误检查不能只看返回值：要用
ERR_print_errors_fp(stderr)看具体报错，常见如error:06065064:digital envelope routines:EVP_DecryptFinal_ex:bad decrypt，说明密钥/IV/密文三者不匹配 - 别忽略
EVP_CIPHER_CTX_free，反复创建 ctx 不释放会导致 OpenSSL 内部堆泄漏
AES 调用就完事，真正的难点在密钥生命周期管理、结构体序列化的确定性、以及文件格式的向后兼容设计——这些地方一旦出错，轻则配置无法读取，重则引入隐蔽的安全漏洞。 
