boost.beast无现成http服务器类，需组合tcp::acceptor、http::request_parser等手动实现异步读写；websocket需确保handshake完成后再收发，共端口时依upgrade头路由；编译须链接libboost_beast并匹配c++标准版本。
怎么用 boost.beast 启一个最简 HTTP 服务器
直接上手写 http::server 不现实——beast 没封装现成的 server 类，得自己组合 tcp::acceptor、http::request_parser 和 http::response_serializer。核心是：接收连接 → 读请求 → 构造响应 → 写回 socket。
常见错误是把 http::read 和 http::write 当同步函数用，结果阻塞整个线程；beast 默认走异步（async_read/async_write），想同步必须显式用 net::use_awaitable 或老老实实加 net::steady_timer 控制超时。
- 用
net::ip::make_address("127.0.0.1")指定监听地址，别硬写字符串 -
http::request<:string_body></:string_body>足够应付 GET/POST 表单，大文件上传得切到http::buffer_body+ 手动流式处理 - 响应状态码别手敲数字，用
http::status::ok、http::status::not_found等枚举，避免拼错或语义混淆
WebSocket 连接建立后怎么收发消息不卡死
WebSocket 不是“连上就能 send”，必须等 websocket::stream::async_handshake 完成且返回 error_code{} 才算真正就绪。很多初学者在 handshake 还没完就调 async_write，结果触发 websocket::error::failed 或静默失败。
收消息也一样：不能指望一次 async_read 拿到完整业务数据，WebSocket 帧可能被 TCP 拆包，beast 的 websocket::stream 会自动重组，但你要确保 buffer 够大（比如用 net::dynamic_buffer），否则 boost::beast::error::need_buffer 就来了。
- 发送二进制帧用
ws.async_write(net::buffer(data), ...)，文本帧加ws.text(true)再 write - 关闭连接必须走
ws.async_close(websocket::close_code::normal)，直接socket.close()会导致对端收到 RST，WebSocket 层无法 clean shutdown - 多个并发连接时，每个
websocket::stream实例必须绑定独立的net::io_context::strand，否则async_read和async_write可能交叉执行，破坏消息顺序
HTTP 和 WebSocket 共享同一个端口怎么路由
beast 不提供 HTTP 路由器，得自己解析 req.target() 和 req[http::field::upgrade] 判断是不是 WebSocket 升级请求。关键点：HTTP 请求里出现 Connection: upgrade 且 Upgrade: websocket，才走 WebSocket 分支，其余走 HTTP 回复逻辑。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
容易漏的是校验 Sec-WebSocket-Key —— beast 的 websocket::stream::async_handshake 会自动验证它，但如果提前 return 或抛异常，handshake 就不会触发，客户端卡在 pending 状态。
- 不要在 upgrade 判断前调
http::write，否则 socket 已写 HTTP 头，再 handshaking 就协议错乱 - WebSocket 路径匹配建议用
boost::beast::string_view做前缀比较（如target.starts_with("/ws")），别用正则，避免 runtime 开销 - 如果 HTTP 服务还要支持 HTTPS，注意
websocket::stream<:stream>></:stream>的嵌套层级，SSL 握手必须在 WebSocket handshake 之前完成
为什么编译报错 “undefined reference to `boost::beast::http::...`”
beast 分 header-only 和需要链接的两部分：HTTP/WS 核心类型（http::request、websocket::stream）是头文件，但某些实现细节（比如 http::write 对 chunked 编码的支持、websocket::stream 的 ping/pong 自动处理）在 libboost_beast 里。只 #include <boost></boost> 不够，还必须链接 -lboost_beast -lboost_asio -lboost_system（Linux/macOS）或对应 .lib（Windows）。
另一个高频坑是 C++ 标准版本不一致：beast v290+ 要求 C++20，若项目用 C++17 编译，net::use_awaitable 直接不可用，报一堆 template substitution failed。
- 确认
BOOST_BEAST_VERSION宏值，v280 对应 Boost 1.78，v290 对应 1.82，别混用头文件和库版本 - 用
cmake时，优先走find_package(Boost REQUIRED COMPONENTS system asio)，而不是手动指定 include path - Clang 下若报
no type named 'executor_type' in 'boost::asio::io_context'，大概率是BOOST_ASIO_HAS_CO_AWAIT未定义或协程支持开关没开全
实际部署时，websocket::stream 的内存生命周期最容易出问题：buffer 生命周期短于 async 操作，或者 handler 捕获了栈变量指针，异步回调时早已析构。这类 bug 不报编译错，只在高并发下偶发 crash —— 得靠 ASan + UBSan 配合 valgrind 抓。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
