openssl c++调用前必须确认三件事：一是安装openssl 1.1.1或3.0+并正确链接-lssl -lcrypto；二是全局调用openssl_init_ssl()初始化；三是使用tls_client_method()而非已弃用的sslv23_client_method()。
OpenSSL C++ 调用前必须确认的三件事
直接上手写 SSL_connect() 前，先停一下：你大概率会卡在链接、证书或上下文初始化这三处。C++ 本身不提供 SSL 封装，所有调用都是对 OpenSSL C API 的裸用，没有 RAII 自动清理，也没有异常安全保证。
- 确认已安装的是 OpenSSL 1.1.1 或 3.0+（
openssl version -a），旧版（如 1.0.2）已停止维护，且 API 行为差异大 - 编译时必须显式链接
-lssl -lcrypto，且顺序不能颠倒——-lcrypto必须在-lssl后面，否则大量未定义符号（如SSL_new、BIO_new_ssl_connect） - 全局初始化只做一次：
OPENSSL_init_ssl(OPENSSL_INIT_SSL_DEFAULT, nullptr)（1.1.1+），不是SSL_library_init()；漏掉会导致后续所有SSL_CTX_new()返回nullptr
SSL\_CTX\_new() 失败的常见原因和绕过方式
SSL_CTX_new() 返回 nullptr 是最常遇到的“黑屏”问题，不是代码写错了，而是环境或配置没对齐。
- 错误现象：
SSL_CTX_new(TLS_client_method())返回空，但ERR_get_error()没报错——大概率是 OpenSSL 初始化失败或线程不安全调用（多线程下未设置CRYPTO_set_locking_callback） - 开发阶段可临时绕过证书验证（仅限测试）：
SSL_CTX_set_verify(ctx, SSL_VERIFY_NONE, nullptr)；但生产环境必须设为SSL_VERIFY_PEER并加载 CA 证书（SSL_CTX_load_verify_locations(ctx, "ca-bundle.crt", nullptr)） - 不要用
SSLv23_client_method()——它已被弃用，在 OpenSSL 3.0+ 中直接返回nullptr；统一改用TLS_client_method()
SSL\_read() 和 SSL\_write() 的阻塞与重试逻辑
这两个函数不是“发完就完”，它们可能返回 -1 并非出错，而是需要你主动检查 SSL_get_error() 判断是否该等 I/O —— 这是 C++ 网络层最容易写崩的地方。
-
SSL_write()返回-1时，若SSL_get_error(ssl, ret) == SSL_ERROR_WANT_WRITE，说明底层 socket 发送缓冲区满，需等待 socket 可写（例如用select()或 epoll_wait）再重试，不是立刻报错退出 -
SSL_read()返回-1且SSL_get_error() == SSL_ERROR_WANT_READ，同理要等 socket 可读；若返回 0，表示对端关闭连接（clean shutdown），不是错误 - 永远不要假设一次
SSL_write()能把整个 buffer 发完——它可能只写入部分字节，返回值就是实际写入长度，需循环处理剩余数据
RAII 封装 SSL\_CTX 和 SSL 对象的最小安全模式
裸用 SSL_CTX_free() 和 SSL_free() 极易内存泄漏或 double-free，尤其在异常路径中。必须手动加 RAII，但不用重造轮子。
立即学习“C++免费学习笔记（深入）”；
- 用
std::unique_ptr配合自定义 deleter：auto ctx_deleter = [](SSL_CTX* p) { if (p) SSL_CTX_free(p); }; std::unique_ptr<SSL_CTX, decltype(ctx_deleter)> ctx{SSL_CTX_new(TLS_client_method()), ctx_deleter}; -
SSL*同理，但注意：一个SSL*必须绑定到唯一 socket fd，且SSL_set_fd()只能调用一次；重复调用不会报错，但后续 I/O 行为不可预测 - 别用
std::shared_ptr管理SSL*——SSL 对象内部有引用计数（SSL_up_ref()），但外部共享指针会干扰其生命周期，导致提前释放或悬垂指针
真正难的不是调通第一个 HTTPS 请求，而是让 SSL 对象在各种异常分支（DNS 失败、connect 超时、证书校验失败、网络中断）下都能被正确释放且不崩溃。每个 SSL_* 函数调用后，都得想清楚：如果下一行 throw 了，这个资源还在不在？
