C++ WebSocket 客戶端開發：主流庫選型、連接建立、消息收發完整實戰

主流 C++ WebSocket 庫對比 (2024)

推薦：Boost.Beast 客戶端最小可行示例 (C++17)

#include 
#include 
#include 
#include 
#include 
#include 
#include 

namespace beast = boost::beast;
namespace websocket = beast::websocket;
namespace net = boost::asio;
namespace ssl = net::ssl;
using tcp = net::ip::tcp;

int main() {
    try {
        // 1. I/O 上下文
        net::io_context ioc;
        ssl::context ctx(ssl::context::tlsv12_client);
        ctx.set_default_verify_paths(); // 信任系統 CA

        // 2. 解析目標
        tcp::resolver resolver(ioc);
        auto const results = resolver.resolve("echo.websocket.org", "443");

        // 3. 建立 TLS + WS 流
        websocket::stream> ws(ioc, ctx);
        
        // 4. 連接 TCP + TLS 握手
        net::connect(ws.next_layer().next_layer(), results);
        ws.next_layer().handshake(ssl::stream_base::client);

        // 5. WebSocket 握手 (Host + Origin)
        ws.set_option(websocket::stream_base::decorator(
            [](websocket::request_type& req) {
                req.set(beast::http::field::user_agent, "Boost.Beast-WS-Client");
            }));
        ws.handshake("echo.websocket.org", "/");

        // 6. 發送文本幀
        std::string msg = "Hello from C++ Boost.Beast!";
        ws.write(net::buffer(msg));
        std::cout << "Sent: " << msg << std::endl;

        // 7. 接收回應
        beast::flat_buffer buffer;
        ws.read(buffer);
        std::cout << "Received: " << beast::make_printable(buffer.data()) << std::endl;

        // 8. 關閉連接
        ws.close(websocket::close_code::normal);
    } catch (std::exception const& e) {
        std::cerr << "Error: " << e.what() << std::endl;
        return 1;
    }
    return 0;
}

CMakeLists.txt 關鍵配置

cmake_minimum_required(VERSION 3.15)
project(ws_client LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
find_package(Boost 1.70 REQUIRED COMPONENTS system ssl)
find_package(OpenSSL REQUIRED)
add_executable(ws_client main.cpp)
target_link_libraries(ws_client PRIVATE Boost::system Boost::ssl OpenSSL::SSL OpenSSL::Crypto)

進階主題

• 自動重連：封裝 `ws.handshake` 於迴圈，指數退避 + 抖動
• 心跳/保活：`ws.ping({})` 定時發送，處理 `pong` 回調
• 二進制幀：`ws.write(net::buffer(binary_data, len), websocket::frame_type::binary)`
• 同步 vs 異步：上例為同步阻塞；高併發需用 `async_handshake`/`async_read`/`async_write` + `io_context.run()` 線程池
• Permessage-Deflate 壓縮：`ws.set_option(websocket::permessage_deflate{})`

Java 服務端互操作驗證

Java 端用 **Spring WebSocket (STOMP over WS)** 或 **Netty/WebSocket** 均遵循 RFC 6455，**只需確保**：
1. 握手路徑一致 (`/ws`, `/websocket` 等)
2. `Sec-WebSocket-Protocol` 協商一致 (如 `v10.stomp`, `v11.stomp`)
3. 幀格式：文本幀 UTF-8、二進制幀任意
4. 心跳間隔協商 (建議雙端 30s ping)

總結

**Boost.Beast 是現代 C++ WebSocket 開發的標準答案**。配合 Asio 生態、CMake、vcpkg/Conan 依賴管理，可構建高性能、跨平台、標準合規的客戶端/服務端。舊專案可用 `websocketpp` 平滑遷移。