双向TLS场景下SSL会话复用问题排查与实现方案咨询

我用C语言开发了客户端-服务器程序，客户端会生成大量线程。为了避免初始SSL重协商拖慢连接性能，我希望后续线程复用首次连接的SSL会话上下文，无需每次新建会话。

原本的复用逻辑是：后续线程调用SSL_new传入全局SSL_CTX，通过SSL_set_fd绑定套接字，用SSL_get1_session获取首次连接的会话，再通过SSL_set_session绑定到新SSL对象，最后调用SSL_set_accept_state完成初始化。

但切换到双向TLS并添加客户端证书验证逻辑后（首次连接用SSL_get_peer_certificate和SSL_get_verify_result验证客户端证书），首次连接的SSL_write正常工作，后续线程的SSL_write却返回-1。以下是问题排查与修复方案：

示例代码 #

// 全局变量
SSL_CTX* mainSSLCTX = NULL;
SSL* mainSSL = NULL;

SSL_CTX * init_server_ssl()
{
    // 省略错误处理
    const SSL_METHOD *method = TLSv1_2_server_method();
    SSL_CTX *ctx = SSL_CTX_new(method);
    SSL_CTX_use_PrivateKey_file(ctx, SERVER_KEY, SSL_FILETYPE_PEM);
    SSL_CTX_use_certificate_file(ctx, SERVER_CERTIFICATE, SSL_FILETYPE_PEM);
    if ( !SSL_CTX_check_private_key(ctx) )
        return NULL;
    SSL_CTX_set_cipher_list(ctx, SERVER_CIPHER_LIST);
    return ctx;
}

bool acceptSSLConnection(SSL_CTX* ssl_ctx, int socketfd, SSL** pssl)
{
    SSL * ssl = SSL_new(ssl_ctx);
    SSL_set_fd(ssl, socketfd);
    if (SSL_accept(ssl) != 1)
        return false;

    if(!verifyClientCertificate(ssl))
        return false;

    (*pssl) = ssl;

    return true;
}

bool verifyClientCertificate(SSL* ssl)
{
    X509* client_cert = SSL_get_peer_certificate(ssl);
    if (!client_cert)
        return false;

    if (SSL_get_verify_result(ssl) != X509_V_OK)
    {
        X509_free(client_cert);
        return false;
    }
    return true;
}

bool get_Existing_Golbal_SSL_Session(SSL_CTX* ssl_ctx, int socketfd, SSL ** pssl)
{
    // 省略错误处理 
    SSL* ssl = SSL_new(ssl_ctx);
    SSL_set_fd(ssl, socketfd);
    SSL_SESSION  *tmpSSLSess = SSL_get1_session(mainSSL);
    SSL_set_session(ssl, tmpSSLSess);
    SSL_set_accept_state(ssl);
    (*pssl) = ssl;
    return true;
}

int main()
{
    mainSSLCTX = init_server_ssl();
    SSL_CTX_set_verify(mainSSLCTX, SSL_VERIFY_PEER | SSL_VERIFY_FAIL_IF_NO_PEER_CERT | SSL_VERIFY_CLIENT_ONCE, NULL);
    SSL_CTX_load_verify_locations(mainSSLCTX, NULL, CERTIFICATES_PATH);

    // 处理首次连接
    acceptSSLConnection(mainSSLCTX, mainSocket, &mainSSL);

    // 处理其他客户端线程
    SSL *sessionSSL;
    get_Existing_Golbal_SSL_Session(mainSSLCTX, currentSocket, &sessionSSL);
}

问题根源 #

1. 会话复用流程错误：双向TLS中，直接用SSL_set_accept_state跳过完整握手，会导致服务器未验证新连接的客户端身份，SSL状态异常，最终SSL_write失败。即使复用会话，也需要完成简化握手以确认客户端持有对应证书/私钥。
2. 引用计数管理缺失：SSL_get1_session会增加会话的引用计数，未手动释放会导致内存泄漏，同时可能引发会话状态混乱。

修复方案 #

1. 修正会话复用流程 #

不要跳过握手，调用SSL_accept让OpenSSL自动完成会话复用与身份验证：

bool reuse_existing_ssl_session(SSL_CTX* ssl_ctx, int socketfd, SSL **pssl)
{
    SSL* ssl = SSL_new(ssl_ctx);
    if (!ssl) return false;

    SSL_set_fd(ssl, socketfd);
    // 获取首次连接的会话并管理引用计数
    SSL_SESSION *session = SSL_get1_session(mainSSL);
    if (session) {
        SSL_set_session(ssl, session);
        SSL_SESSION_free(session); // 释放引用，避免内存泄漏
    }

    // 执行握手，OpenSSL会自动复用会话并完成客户端证书验证
    if (SSL_accept(ssl) != 1) {
        SSL_free(ssl);
        return false;
    }

    // 二次确认客户端证书（可选，确保身份验证有效）
    if (!verifyClientCertificate(ssl)) {
        SSL_free(ssl);
        return false;
    }

    *pssl = ssl;
    return true;
}

2. 配置SSL_CTX支持会话缓存 #

显式开启服务器端会话缓存，确保会话可以被复用：

// 在init_server_ssl函数中添加
SSL_CTX_set_session_cache_mode(mainSSLCTX, SSL_SESS_CACHE_SERVER | SSL_SESS_CACHE_NO_INTERNAL_STORE);
// 调整缓存大小，根据并发量设置
SSL_CTX_sess_set_cache_size(mainSSLCTX, 1024);

3. 线程安全保障 #

• 全局mainSSL和mainSSLCTX的访问需加互斥锁，避免并发读写冲突。
• 每个线程使用独立的SSL对象，仅共享SSL_CTX和SSL_SESSION。

4. 错误排查技巧 #

当SSL_write返回-1时，调用SSL_get_error获取具体错误码定位问题：

int ret = SSL_write(ssl, buf, len);
if (ret <= 0) {
    int err = SSL_get_error(ssl, ret);
    printf("SSL_write错误码: %d\n", err);
    // 错误码对应场景：
    // SSL_ERROR_SSL：握手或验证失败
    // SSL_ERROR_WANT_READ/SSL_ERROR_WANT_WRITE：需继续IO操作，非真正错误
    // SSL_ERROR_SYSCALL：套接字等系统调用错误
}

关键注意事项 #

• 双向TLS下不能跳过握手，必须通过SSL_accept完成简化握手，确保客户端身份验证完成。
• 严格管理SSL_SESSION的引用计数，使用SSL_get1_session后必须调用SSL_SESSION_free释放。
• 客户端需支持会话复用，连接时提供会话标识，否则服务器无法复用会话。

内容的提问来源于stack exchange，提问作者Homaei