openssl 1.1.1+ 是强制要求，需验证版本日期晚于2018-09-11且支持tls 1.3密码套件；必须显式调用ssl_ctx_set_min_proto_version(ctx, tls1_3_version)和max同设，否则仍可能降级至tls 1.2。
OpenSSL 1.1.1+ 是硬性门槛
不支持 TLS 1.3 的 OpenSSL 版本（比如 1.0.2 或 1.1.0）会直接忽略 TLSv1_3_method()，甚至编译时报 undefined reference。必须用 OpenSSL 1.1.1 或更新版本（如 3.0.x），且编译时不能禁用 TLS 1.3（默认开启，但某些发行版打包可能关掉）。
验证方法：openssl version -a 看输出是否含 built on 日期晚于 2018-09-11，再跑 openssl ciphers -s -tls1_3 确认有输出（如 TLS_AES_256_GCM_SHA384）。
- 静态链接时，确保
libssl.a和libcrypto.a来自同一 OpenSSL 1.1.1+ 构建 - 动态链接时，
LD_LIBRARY_PATH要指向新版库路径，避免系统旧版libssl.so.1.1干扰 - macOS 上用 Homebrew 安装的 OpenSSL 默认不替换系统库，需显式指定
-I/opt/homebrew/include -L/opt/homebrew/lib
SSL_CTX_set_min_proto_version() 必须显式设为 TLS1_3_VERSION
即使调用 TLSv1_3_method()，OpenSSL 默认仍允许降级到 TLS 1.2 —— 这不是 bug，是兼容性设计。要真正强制只用 TLS 1.3，必须关闭低版本协议：
SSL_CTX* ctx = SSL_CTX_new(TLSv1_3_method()); SSL_CTX_set_min_proto_version(ctx, TLS1_3_VERSION); SSL_CTX_set_max_proto_version(ctx, TLS1_3_VERSION);
- 漏设
set_min_proto_version是最常见错误：握手时对方仍可能协商 TLS 1.2，你以为用了 1.3，其实没用 -
TLSv1_3_client_method()和TLSv1_3_server_method()已废弃，统一用TLSv1_3_method()+ 显式版本控制 - 服务端若需兼容老客户端，可设
min = TLS1_2_VERSION，但此时无法保证每次都是 TLS 1.3
证书和密钥加载失败会导致 TLS 1.3 握手静默失败
TLS 1.3 对证书链校验更严格，且部分旧证书（如 SHA-1 签名、RSA 密钥长度 SSL_accept()，而是在 SSL_do_handshake() 返回 -1 后，需查 SSL_get_error() + ERR_print_errors_fp() 才能看到 error:1417B07B:SSL routines:tls_process_cert_verify:bad signature 这类信息。
- 服务端必须加载完整证书链（包括中间 CA），单个
cert.pem文件不够 - 私钥格式必须是 PEM 且未加密（或已用
SSL_CTX_use_PrivateKey_file()解密），PKCS#8 格式需确认 OpenSSL 版本支持 - 客户端验证服务端证书时，若用
SSL_CTX_set_verify(ctx, SSL_VERIFY_PEER, nullptr)却没调SSL_CTX_load_verify_locations()加载 CA 证书，TLS 1.3 握手会直接失败，不像 TLS 1.2 可能容忍
ALPN 协商失败不会阻止 TLS 1.3 建立，但影响上层协议
TLS 1.3 的 ALPN（Application-Layer Protocol Negotiation）是可选扩展，不影响加密通道建立。但如果业务依赖 HTTP/2 或自定义协议，ALPN 协商失败会导致后续通信异常，而错误日志里看不到 TLS 层报错。
服务端设置示例：
const char* protocols[] = {"h2", "http/1.1"};
SSL_CTX_set_alpn_protos(ctx, reinterpret_cast<const unsigned char>(protocols), 7); // 7 = strlen("h2") + strlen("http/1.1") + 2
</const>
- 客户端和服务端 ALPN 列表无交集时，
SSL_get0_alpn_selected()返回空，但握手成功 —— 很容易误判为“连通了” - OpenSSL 3.0+ 中
SSL_set_alpn_protos()参数类型改为const unsigned char*，长度需手动算，传错会崩溃 - HTTP/2 要求 TLS 1.3 + ALPN + 加密套件支持 ECDHE，三者缺一不可；只开 TLS 1.3 不代表能跑 h2
真正难调的不是握手本身，而是当 SSL_do_handshake() 返回 1 之后，你得立刻检查 ALPN 结果、证书有效性、密钥交换参数（如 SSL_get_shared_ciphers() 是否含 TLS_AES_256_GCM_SHA384），这些点全靠手动验证，OpenSSL 不主动告诉你哪步“看似成功实则无效”。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
