openssl 1.1.0+必须显式调用openssl_init_ssl()初始化，否则ssl_ctx_new()等函数行为未定义；启用证书校验需ssl_ctx_set_verify()并设置ca路径；bio读写须循环处理且注意http请求格式；ssl_ctx和bio必须手动释放，推荐bio_free_all()。
OpenSSL初始化失败：忘记调用OPENSSL_init_ssl()和OPENSSL_init_crypto()
很多C++新手直接跳进SSL_CTX_new()就报段错误或返回nullptr，根本原因是OpenSSL 1.1.0+已废弃SSL_library_init()和OPENSSL_add_all_algorithms()，必须显式初始化。不初始化，后续所有SSL函数行为未定义。
实操建议：
- 程序启动时（如
main()开头）调用OPENSSL_init_ssl(OPENSSL_INIT_SSL_DEFAULT, nullptr)，它会自动触发OPENSSL_init_crypto()，无需单独调； - 若需控制加密算法加载（如禁用弱算法），可传入
OPENSSL_INIT_NO_LOAD_CRYPTO_STRINGS等标志； - 旧代码迁移时注意：去掉
SSL_load_error_strings()和ERR_load_BIO_strings()，它们在新init中已默认启用。
建立TLS连接时验证失败：证书校验逻辑没配对
常见现象是SSL_connect()返回0或-1，SSL_get_error()返回SSL_ERROR_SSL，日志里出现“unable to get local issuer certificate”或“certificate verify failed”。这不是网络问题，而是客户端没告诉OpenSSL去哪里找CA根证书，或没开启验证。
实操建议：
- 必须调用
SSL_CTX_set_verify(ctx, SSL_VERIFY_PEER, nullptr)启用校验（仅设SSL_VERIFY_NONE等于裸奔）； - 设置CA路径：
SSL_CTX_set_default_verify_paths(ctx)自动加载系统默认路径（Linux的/etc/ssl/certs、macOS的Keychain）； - 若需指定自定义CA bundle（如Windows下无系统路径），用
SSL_CTX_load_verify_locations(ctx, "ca-bundle.crt", nullptr)； - 验证回调可省略（用默认行为），但若要跳过特定域名验证（仅调试！），需自定义回调并
return 1——生产环境禁止这么做。
发送HTTP请求后收不到响应：BIO阻塞与读取逻辑写错
成功SSL_connect()后，用BIO_write()发GET请求，但BIO_read()一直返回0或负值，或者只读到HTTP头就卡住。问题通常出在BIO类型选择和读取循环上。
实操建议：
- 务必使用
BIO_s_socket()+BIO_new_ssl_connect()组合，不要手动socket()+connect()再套SSL； -
BIO_set_conn_hostname(bio, "example.com:443")后必须调BIO_do_connect(bio)，它内部完成TCP握手； - 发送完请求后，用
BIO_do_handshake(bio)确认TLS层就绪（虽然BIO_do_connect()已隐式做，但显式调更安全）； - 读响应时，必须循环
BIO_read()直到返回≤0且BIO_should_retry()为假；单次读可能只拿到部分数据； - 别忘了在HTTP头末尾加
"\r\n\r\n"，否则服务器不认为请求结束。
内存泄漏与资源释放：SSL_CTX和BIO对象没正确清理
运行多次HTTPS请求后进程RSS持续上涨，Valgrind报告大量SSL_CTX、SSL、BIO未释放。OpenSSL不自动管理这些堆对象，必须手动释放。
实操建议：
- 每个
SSL_CTX_new()对应一个SSL_CTX_free(ctx)，通常在程序退出前或连接池销毁时调； - 每个
BIO_new_ssl_connect()生成的BIO*，必须用BIO_free_all(bio)（不是BIO_free()），因为它内部关联了SSL*对象； - 若用了
SSL_new(ctx)手动创建SSL对象，必须配对SSL_free(ssl)； - 不需要调
CRYPTO_cleanup_all_ex_data()（OpenSSL 1.1.0+已弃用），也不需要ERR_free_strings()。
最易被忽略的是BIO的嵌套释放顺序：用BIO_free_all()一步到位比逐层释放更安全。另外，多线程环境下SSL_CTX可复用，但每个连接必须独占一个BIO或SSL对象，共享会导致状态混乱。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
