应使用 OpenSSL 而非自行实现加解密逻辑，因其是成熟安全的事实标准；需规范使用其 API、封装胶水层、统一 AEAD 抽象、严谨处理 TLS 错误与 SNI 验证，并重视密钥生命周期管理。
用 OpenSSL 还是自己写加解密逻辑？
别自己实现加密算法。C++ 没有标准加密库，硬写 AES 或 RSA 密钥派生、填充、IV 管理，99% 会出安全漏洞。OpenSSL 是事实标准，但它的 C 风格 API 容易误用——比如忘记调用 ERR_clear_error() 导致错误码污染，或在 EVP_CIPHER_CTX 未初始化时直接传给 EVP_EncryptUpdate() 触发段错误。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用 OpenSSL 1.1.1+（支持 TLS 1.3 和 ChaCha20-Poly1305），避免用已废弃的
DES_ecb_encrypt()等老接口 - 封装一层薄胶水类，只暴露
encrypt()/decrypt()接口，内部强制校验ctx状态和返回值（OpenSSL 多数函数失败返回 0，不是 -1） - 密钥和 IV 绝不硬编码；从系统随机源读取：
RAND_bytes()，而非rand()
如何让同一套传输层切换 AES-GCM 和 ChaCha20-Poly1305？
不能靠 if-else 切换算法分支——不同 AEAD 模式对 IV 长度、标签长度、密钥调度要求不同。AES-GCM 要求 12 字节 IV，ChaCha20-Poly1305 要求 12 或 24 字节，且后者不依赖硬件加速，但在 x86 上可能比 AES 慢 20%。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 定义统一的
AEADContext抽象基类，子类分别实现AES_GCM_Context和ChaCha20_Poly1305_Context，把 IV 生成、加密、验证逻辑隔离 - 在握手阶段协商算法：客户端发
supported_algorithms = {"aes-gcm-256", "chacha20-poly1305"}，服务端选第一个可用的并回传确认 - 注意
EVP_CIPHER_CTX_ctrl()对 GCM 的 tag 长度设置必须在EVP_EncryptInit_ex()后、EVP_EncryptUpdate()前调用，否则无效
TLS 握手失败时，SSL_get_error() 返回 SSL_ERROR_SYSCALL 怎么查？
这不是 TLS 协议错误，而是底层 I/O 出问题：可能是 socket 已关闭、对方 FIN 包未读完、或 errno 被其他库覆盖。常见于异步 I/O 场景下未正确处理 SSL_ERROR_WANT_READ/WRITE 就强行重试，导致 SSL_read() 返回 -1 且 errno == 0，最终被映射成 SSL_ERROR_SYSCALL。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 每次调用
SSL_read()或SSL_write()后，先检查返回值是否为 -1，再调用SSL_get_error()，绝不能跳过这一步 - 若返回
SSL_ERROR_SYSCALL，立刻检查errno：若为 0，大概率是 SSL 状态异常（如未完成握手就发应用数据）；若为EAGAIN或EWOULDBLOCK，说明是阻塞模型误用非阻塞 socket - 启用 OpenSSL 错误栈打印：
ERR_print_errors_fp(stderr)，但仅用于调试——生产环境不要留它，会泄露内存地址等信息
为什么用 SSL_set_tlsext_host_name() 后仍被证书校验拒绝？
这个函数只设置 SNI 扩展字段，不参与本地证书验证。真正触发域名不匹配错误的是 X509_check_host()，它在 SSL_get_peer_certificate() 后由默认验证回调调用。如果你禁用了默认验证（如设了 SSL_VERIFY_NONE），那 SNI 设置了也没用；反之若启用了验证但没调用 SSL_set1_host()，就会因 CN/SAN 不匹配失败。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 服务端必须调用
SSL_set_tlsext_host_name()，客户端必须调用SSL_set1_host()并确保证书包含对应 SAN 条目 - 自签名或内网证书场景下，可注册自定义验证回调，但务必保留主机名检查逻辑——删掉
X509_check_host()调用等于放弃域名绑定 - 调试时用
openssl s_client -connect host:port -servername host验证 SNI 是否送达，比代码里打日志更可靠
最麻烦的不是选算法，而是密钥生命周期管理：会话密钥怎么安全导出？前向保密怎么保证？这些地方一错，前面所有加密都白搭。
