Boost Beast握手报bad version、写入报Operation cancelled问题排查

问题背景 #

基于Beast 1.70.0实现本地通信的WebSocket客户端与服务端，编译正常。以root权限运行（因bind()需要）时，握手阶段在on_handshake()回调中触发"bad version"错误，写入阶段在on_write()回调中触发"Operation cancelled"错误。此前保留resolver且不绑定本地端点时程序运行正常，修改为绑定本地端点后出现该问题，未修改握手相关代码，调试时无法查看握手细节。

排查方向与解决方案 #

1. 绑定本地端点的TCP配置与顺序问题 #

• 检查绑定参数与状态：确认绑定的本地地址/端口合法，排查是否存在端口占用（可通过netstat -tulpn）、地址重用未开启的情况。root权限下需注意系统级端口限制（如1024以下端口的使用规则）。
• 修正操作顺序：若绑定本地端点后仍使用resolver解析连接，需确保操作顺序正确。正确流程应为绑定后直接连接服务端端点，而非混用resolver：

  // 客户端示例：绑定本地端点后直接连接服务端
  boost::asio::io_context ioc;
  websocket::stream<beast::tcp_stream> ws(ioc);
  
  // 绑定本地随机端口
  ws.next_layer().bind(boost::asio::ip::tcp::endpoint{
      boost::asio::ip::address::from_string("127.0.0.1"), 0});
  
  // 直接连接服务端端点
  boost::asio::ip::tcp::endpoint server_ep(
      boost::asio::ip::address::from_string("127.0.0.1"), 8080);
  ws.next_layer().connect(server_ep);
  

• 设置必要TCP选项：绑定后确保开启TCP_NODELAY，避免Nagle算法导致的握手延迟：

  ws.next_layer().set_option(boost::asio::ip::tcp::no_delay(true));
  

2. WebSocket握手版本协商排查 #

• "bad version"错误本质：该错误表示客户端与服务端的WebSocket版本不兼容，通常是握手请求中的Sec-WebSocket-Version字段无效或不匹配。
• 启用握手日志：通过Beast装饰器打印握手请求/响应头，确认版本字段：

  // 客户端打印请求头
  ws.set_option(websocket::stream_base::decorator(
      [](websocket::request_type& req)
      {
          std::cerr << "Client handshake request:\n" << req << std::endl;
      }));
  
  // 服务端打印响应头
  ws.set_option(websocket::stream_base::decorator(
      [](websocket::response_type& res)
      {
          std::cerr << "Server handshake response:\n" << res << std::endl;
      }));
  

  正常的Sec-WebSocket-Version值应为13（对应RFC6455）。
• 抓包验证：用Wireshark抓取本地回环（lo接口）的包，检查握手阶段的HTTP请求是否完整，是否存在TCP分段导致的头截断。

3. 异步操作生命周期问题 #

• "Operation cancelled"原因：该错误通常是异步操作上下文（如io_context、strand）提前停止，或WebSocket流对象在操作完成前被销毁。
• 确保对象生命周期安全：用std::shared_ptr管理WebSocket流对象，回调中捕获智能指针引用避免悬空：

  class ClientSession : public std::enable_shared_from_this<ClientSession>
  {
  public:
      void do_handshake()
      {
          auto self(shared_from_this());
          ws.async_handshake(host, "/",
              [self](beast::error_code ec)
              {
                  if(ec)
                      return fail(ec, "handshake");
                  // 后续操作
              });
      }
  private:
      websocket::stream<beast::tcp_stream> ws;
  };
  

• 确认io_context运行状态：确保io_context.run()在所有异步操作完成前未被停止，排查root权限下是否有信号处理导致io_context意外退出。

4. Beast版本兼容性问题 #

• 升级Beast版本：Beast 1.70.0（对应Boost 1.70）是较旧版本，存在流状态处理相关bug。建议升级到Boost 1.76及以上版本，新版本修复了多个WebSocket绑定相关问题。
• 查阅版本日志：查看Beast 1.70.0到后续版本的release notes，确认是否有与绑定本地端点相关的bug修复记录。

代码检查要点 #

• 客户端绑定本地端点的代码是否修改了tcp_stream的状态，导致握手时流处于异常状态？
• 服务端的acceptor是否正确设置了reuse_address选项，避免root权限下的端口绑定冲突？
• 是否在绑定后调用了ws.next_layer().close()或其他重置流的操作？

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