openssl 1.1.1及以上版本且编译时启用enable-tls1_3才真正支持tls 1.3；需用ssl_ctx_set_min/max_proto_version强制限定版本，并确保证书链完整、私钥未加密、sni匹配，同时正确处理ssl_read/write返回值及ssl_error_want_accept等特殊错误。
怎么确认OpenSSL版本真正支持TLS 1.3
OpenSSL 1.1.1 是第一个稳定支持 TLS 1.3 的发行版，但很多系统自带的 libssl 仍是 1.0.2 或更老版本——它们根本无法启用 TLS 1.3，哪怕代码里写了 TLS1_3_VERSION 也会静默降级到 TLS 1.2。
运行 openssl version -a 查看实际链接的库路径和编译参数。关键要看两行：
-
built on: ...—— 确认是 2018 年 9 月之后的构建（1.1.1首发时间） -
options: ... enable-tls1_3—— 必须出现这个标记，否则 TLS 1.3 被编译时禁用
如果没看到 enable-tls1_3，说明你链接的是一个阉割版 OpenSSL，必须重新编译安装，不能只靠 apt install libssl-dev。
SSL_CTX 配置中哪些调用会强制启用 TLS 1.3
仅靠 TLS_server_method() 或 TLS_client_method() 不足以锁定 TLS 1.3：OpenSSL 默认兼容性优先，会协商出双方都支持的最高版本（可能是 TLS 1.2）。
必须显式限制协议范围：
- 服务端：调用
SSL_CTX_set_min_proto_version(ctx, TLS1_3_VERSION)和SSL_CTX_set_max_proto_version(ctx, TLS1_3_VERSION) - 客户端：同理，用
SSL_CTX_set_min_proto_version+SSL_CTX_set_max_proto_version - 注意：这两个函数在 OpenSSL
1.1.1及以上才有效；1.0.2会忽略它们且不报错
漏掉任一调用，就可能在调试时发现握手成功但抓包显示用的是 TLS 1.2——因为服务器或客户端没“坚持”。
证书加载失败时常见的静默陷阱
OpenSSL 加载证书失败不会直接崩溃，而是让后续 SSL_accept() 或 SSL_connect() 返回 ≤0，并输出模糊错误（如 ssl routines:ssl3_read_bytes:ssl handshake failure）。
真正原因往往藏在证书链细节里：
-
SSL_CTX_use_certificate_file()只接受单个 PEM 文件，且必须是**完整证书链**（服务器证书 + 中间 CA），不能只放server.crt -
SSL_CTX_use_PrivateKey_file()的私钥必须未加密（即无密码），或你得额外调用SSL_CTX_set_default_passwd_cb()提供解密回调 - 证书域名必须匹配 SNI 请求——如果客户端没发 SNI（比如用
curl --resolve强制 IP），而证书是example.com，握手会失败且错误码不提示域名问题
建议在 SSL_CTX_use_certificate_file() 后立刻检查返回值，失败时用 ERR_print_errors_fp(stderr) 打印完整错误栈。
SSL_read / SSL_write 返回值处理的典型误判
TLS 1.3 的记录层加密更严格，SSL_read() 和 SSL_write() 在非阻塞模式下更容易返回 SSL_ERROR_WANT_READ 或 SSL_ERROR_WANT_WRITE，但这不是错误，而是需要重试。
常见错误写法：
- 把
SSL_read() == 0当作连接关闭（其实是对方调用了SSL_shutdown()的第一阶段，需继续调用SSL_read()完成双向关闭） - 把
SSL_write() 直接断开连接（可能只是内核发送缓冲区满，应检查 <code>SSL_get_error()再决定是否等待可写事件） - 忽略
SSL_ERROR_SSL类错误（如证书校验失败、ALPN 协商不匹配），这类错误需结合SSL_get_verify_result()或日志进一步定位
真正安全的做法：每次调用后都用 SSL_get_error(ssl, ret) 判断类型，仅对 SSL_ERROR_SYSCALL 和 SSL_ERROR_SSL 做终止处理，其余一律重试或等待 I/O 事件。
最易被忽略的点是：TLS 1.3 的 0-RTT 模式下，客户端可能在第一次 SSL_write() 就发送加密应用数据，但服务端必须在完成 SSL_accept() 后才能读取——若服务端逻辑在握手完成前就尝试 SSL_read()，会返回 SSL_ERROR_WANT_ACCEPT（OpenSSL 1.1.1+ 新增），这个错误码文档极少提及，却真实存在。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
