必须用evp_encryptinit_ex等新接口配对加密解密，确保算法、密钥长度、模式、填充、iv完全一致；密钥和iv需二进制字节流，cbc/gcm模式iv须唯一随机；pbkdf2派生密钥并单独生成iv；务必加密后立即验证解密。
怎么用 OpenSSL 的 EVP 接口做 AES 加密（C++）
直接上手就得用 EVP_EncryptInit_ex、EVP_EncryptUpdate、EVP_EncryptFinal_ex 这一套，别碰底层的 AES_encrypt —— 它不处理模式、填充、IV，容易出错还难维护。
关键不是“能不能”，而是“怎么配对”。AES 加密必须和解密在算法、密钥长度、模式、填充、IV 生成方式上完全一致，否则解出来就是乱码或报错 bad decrypt。
-
EVP_aes_128_cbc()、EVP_aes_256_gcm()这类函数名必须和你实际选的密钥长度、工作模式严格匹配，不能混用 - 密钥和 IV 都得是二进制字节流，不是字符串；如果从字符串来，必须明确是 hex 还是 base64，且要正确 decode
- CBC 模式下 IV 必须随机且每次加密不同；GCM 模式下 IV（nonce）也必须唯一，但可以是计数器，不能重复
为什么 EVP_CIPHER_CTX_new() 后必须调 EVP_EncryptInit_ex 而不是 EVP_EncryptInit
EVP_EncryptInit 是旧接口，已弃用，它会自动分配并管理 EVP_CIPHER_CTX 内部资源，但 C++ 里容易和 RAII 冲突，且无法复用上下文。新版一律用 EVP_EncryptInit_ex，它要求你传入已分配的 ctx，控制更清晰，也方便后续重用上下文做多次加解密。
- 必须先调
EVP_CIPHER_CTX_new()，再传给EVP_EncryptInit_ex()，顺序反了会 segfault - 第四个参数是 IV：如果是 NULL，OpenSSL 会自动生成（仅限部分模式），但你不该依赖它 —— 显式传入更可控
- 第五个参数是密钥：长度必须和算法匹配（如
EVP_aes_128_cbc()要 16 字节，EVP_aes_256_cbc()要 32 字节），少一字节都会失败返回 0
解密失败常见报错：bad decrypt 或 final block not padded correctly
这两个错误几乎都指向填充或 IV 不匹配，而不是密钥错了。OpenSSL 解密时会校验 PKCS#7 填充，只要最后一步 EVP_DecryptFinal_ex 返回 0，基本就是 padding 错了。
- 检查加密和解密用的
EVP_CIPHER是否完全一致（比如一个是EVP_aes_128_cbc()，另一个写成EVP_aes_128_ecb()） - 确认解密时传的 IV 和加密时用的是同一份 —— 很多人把 IV 当作“可丢弃的辅助信息”，其实它必须和密文一起保存/传输
- 如果你用了
EVP_CIPHER_CTX_set_padding(ctx, 0)关闭填充（比如处理固定长度数据），那加解密两端都得关，否则一端有 pad 一端没 pad，必然失败 - GCM 模式还要额外校验 tag：解密前必须用
EVP_CIPHER_CTX_ctrl(ctx, EVP_CTRL_GCM_SET_TAG, ...)设置收到的 tag，漏了就直接失败
要不要自己实现密钥派生（比如 PBKDF2）
如果用户密码是字符串，不要直接当 AES 密钥用。AES 密钥必须是固定长度的二进制数据（128/192/256 bit），而用户密码长短不一、熵低、含非 ASCII 字符，直接 memcpy 过去会崩溃或被暴力破解。
- 必须用
PKCS5_PBKDF2_HMAC把口令转成合规密钥：指定 salt（至少 16 字节随机）、迭代次数（>= 100000）、输出长度（如 32） - salt 不能硬编码，也不能每次一样；它要和密文一起存，但不用保密
- 别用 MD5 或 SHA1 做 HMAC 底层哈希 ——
PKCS5_PBKDF2_HMAC第四个参数必须是EVP_sha256()这类现代摘要算法 - 注意：PBKDF2 输出的是密钥，IV 还得另外生成（比如用
RAND_bytes()），两者不能共用同一段派生结果
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
