改编Boost Beast异步SSL WebSocket示例时SSL未初始化错误的修复

出现accept: uninitialized (SSL routines)错误的核心原因是SSL上下文未正确关联到WebSocket流，或未完成SSL握手流程就尝试WebSocket协议升级。以下是针对性修复步骤：

1. 确保Listener持有有效SSL上下文引用 #

Listener类必须持有ssl::context&类型的成员，保证创建Session时能传递正确初始化的SSL上下文：

class listener : public std::enable_shared_from_this<listener>
{
    tcp::acceptor acceptor_;
    ssl::context& ctx_; // 持有SSL上下文引用

public:
    listener(net::io_context& ioc, tcp::endpoint endpoint, ssl::context& ctx)
        : acceptor_(ioc, endpoint)
        , ctx_(ctx) // 构造时传入上下文
    {
        do_accept();
    }

    // ... 其他方法
};

2. 在on_accept中正确传递资源给Session #

当TCP连接accept完成后，需要将已建立的socket和SSL上下文一并传递给Session，确保WebSocket流能初始化SSL层：

void listener::on_accept(beast::error_code ec, tcp::socket socket)
{
    if(ec)
        return fail(ec, "accept");

    // 创建Session时传入socket和SSL上下文
    std::make_shared<session>(std::move(socket), ctx_)->run();

    // 继续监听下一个连接
    do_accept();
}

3. 正确初始化Session的WebSocket SSL流 #

Session的WebSocket流必须是websocket::stream<ssl::stream<tcp::socket>>类型，构造时用socket和SSL上下文初始化：

class session : public std::enable_shared_from_this<session>
{
    websocket::stream<ssl::stream<tcp::socket>> ws_;

public:
    explicit session(tcp::socket socket, ssl::context& ctx)
        : ws_(std::move(socket), ctx) // 初始化SSL流
    {}

    // ... 其他方法
};

4. 先完成SSL握手再执行WebSocket升级 #

Session启动时，必须先执行SSL服务器端握手，完成后再进行WebSocket协议升级，不能颠倒顺序：

void session::run()
{
    // 设置SSL握手模式为服务器端，并启动异步握手
    ws_.next_layer().async_handshake(
        ssl::stream_base::server,
        beast::bind_front_handler(&session::on_handshake, shared_from_this())
    );
}

void session::on_handshake(beast::error_code ec)
{
    if(ec)
        return fail(ec, "ssl_handshake");

    // SSL握手完成后，执行WebSocket协议升级
    ws_.async_accept(
        beast::bind_front_handler(&session::on_ws_accept, shared_from_this())
    );
}

5. 验证SSL上下文初始化正确性 #

在main函数中，确保SSL上下文已正确加载证书和私钥，且无初始化错误：

int main()
{
    // ... 初始化io_context等

    ssl::context ctx{ssl::context::tlsv12_server};

    // 加载证书和私钥，必须检查错误
    beast::error_code ec;
    ctx.use_certificate_chain_file("server.crt", ec);
    if(ec)
        return fail(ec, "load_cert_chain");

    ctx.use_private_key_file("server.key", ssl::context::pem, ec);
    if(ec)
        return fail(ec, "load_private_key");

    // 创建listener并运行io_context
    std::make_shared<listener>(ioc, endpoint, ctx);
    ioc.run();
}

常见排查点 #

• 检查证书/私钥文件路径是否正确，文件权限是否允许程序读取
• 确认Listener传递给Session的是SSL上下文的引用，而非临时对象
• 避免在SSL握手完成前调用websocket::stream::async_accept

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