OpenSSL是C++ TLS连接的事实标准库，需按序初始化OPENSSL_init_ssl→SSL_CTX_new→设置验证路径与SNI，用SSL_read/write代替socket函数，错误时查SSL_get_error而非errno。
用 OpenSSL 实现 C++ 客户端 TLS 连接最直接
直接上手就得选 OpenSSL，它仍是 C++ 里事实标准的 TLS 底层库。别被“C 风格 API”吓住——封装一层就能用得顺手。核心是 SSL_CTX 初始化、SSL 对象绑定 socket、再走 SSL_connect() 或 SSL_accept()。
常见错误：调用 SSL_connect() 前没调用 SSL_set_fd()；或者忘了在 SSL_CTX_new() 后调用 SSL_CTX_set_verify() 控制证书校验行为（比如开发时临时跳过验证，用 SSL_VERIFY_NONE）。
实操建议：
- 初始化必须按顺序：
OPENSSL_init_ssl()→SSL_CTX_new()→SSL_CTX_set_default_verify_paths()（加载系统 CA） - 客户端务必调用
SSL_set_tlsext_host_name()设置 SNI，否则连很多现代 HTTPS 服务会失败 - 读写不能直接用
recv()/send()，必须用SSL_read()和SSL_write() - 出错时查
SSL_get_error()，不是看errno—— 比如SSL_ERROR_WANT_READ表示底层 socket 还没就绪，得等可读事件
为什么别自己解析 PEM 证书或硬编码 CA
有人想省事，把 CA 证书内容 const char* 写死进代码，或者用 fopen() 读 PEM 后手动 PEM_read_bio_X509() 解析——这既难维护又容易漏掉链式验证逻辑。
立即学习“C++免费学习笔记（深入）”；
OpenSSL 提供了更稳妥的路径：
- 用
SSL_CTX_set_default_verify_paths()自动加载系统信任库（Linux 的/etc/ssl/certs，macOS 的 keychain，Windows 的 Cert Store） - 若需自定义 CA，用
SSL_CTX_load_verify_locations(ctx, "ca-bundle.crt", nullptr)，传绝对路径或相对路径（注意当前工作目录影响） - 禁用证书验证仅用于测试：设
SSL_CTX_set_verify(ctx, SSL_VERIFY_NONE, nullptr)，但上线前必须改回SSL_VERIFY_PEER
Boost.Beast + OpenSSL 封装后怎么发 HTTPS 请求
如果你已经在用 Boost.Asio，boost::beast::ssl_stream 是比裸 OpenSSL 更安全的选择。它把 BIO、握手状态、缓冲区管理都包好了，你只管写异步读写逻辑。
关键点：
- 构造
ssl_stream时传入的ssl::context必须已调用add_certificate_authority()或set_default_verify_paths() - 发起连接后必须显式调用
async_handshake(ssl::stream_base::client, ...)，不能跳过 - HTTP/1.1 请求头里必须带
Host字段，且值要和 TLS SNI 一致，否则服务端可能返回 421 或直接断连 - 别在 handshake 完成前发数据，
async_write会失败并报ssl_stream::handshake_required
遇到 SSL_ERROR_SYSCALL 或 “tlsv1 alert unknown ca” 怎么快速定位
这两个错误最常出现，但原因截然不同：SSL_ERROR_SYSCALL 往往是 socket 层断了（比如对端 close、防火墙拦截、DNS 失败），而 tlsv1 alert unknown ca 是服务端不信任你发过去的证书链（通常是客户端证书场景）或你没提供正确 CA。
排查优先级：
- 先用命令行验证通路：
openssl s_client -connect example.com:443 -servername example.com，看是否能完成 handshake - 如果命令行也失败，大概率是网络或服务端配置问题；如果命令行成功，说明你的 C++ 代码里
SSL_CTX初始化或 SNI 设置有遗漏 - 启用 OpenSSL 日志：
SSL_CTX_set_info_callback(ctx, [](const SSL*, int where, int ret) { if (where & SSL_ST_CONNECT) printf("state: %x → %x\n", where, ret); })，观察状态流转 - 检查证书有效期、域名匹配（CN 或 SAN）、中间证书是否缺失——
openssl verify -untrusted intermediate.pem server.pem
真正麻烦的永远不是握手本身，而是证书链完整性、SNI 与 Host 头的一致性、以及错误码背后的真实 socket 状态。这些地方一错，debug 花的时间远超写代码。
