推荐用Boost.Beast实现最简HTTP服务器，因其封装了socket、HTTP解析与状态机，避免手动处理分块传输、keep-alive、CRLF等易错细节；示例代码50行内可运行，同步模式下用http::read()和http::write()即可快速验证。
用 Boost.Beast 写最简 HTTP 服务器，50 行内可跑通
直接上手推荐 Boost.Beast，不是因为“它很强大”，而是它把底层 socket、HTTP 解析、状态机全封装好了，且不依赖 Boost.Asio 以外的模块。自己用原生 socket() + read()/write() 实现 HTTP/1.1 是可能的，但处理分块传输、keep-alive、header 边界、CRLF 换行、URL 解码等细节极易出错——90% 的“手写 HTTP 服务器”在真实请求下会卡死或返回 400。
示例（C++17，需链接 -lboost_system -lpthread）：
#include <boost/beast/core.hpp>
#include <boost/beast/http.hpp>
#include <boost/beast/version.hpp>
#include <boost/asio/ip/tcp.hpp>
#include <boost/asio.hpp>
namespace http = boost::beast::http;
namespace net = boost::asio;
using tcp = net::ip::tcp;
void handle_request(http::request<http::string_body>& req,
http::response<http::string_body>& res) {
res.set(http::field::server, "Beast");
res.result(http::status::ok);
res.body() = "Hello from C++\n";
res.prepare_payload();
}
int main() {
net::io_context ioc;
tcp::acceptor acceptor(ioc, {tcp::v4(), 8080});
for (;;) {
tcp::socket socket(ioc);
acceptor.accept(socket);
http::request<http::string_body> req;
http::read(socket, boost::beast::flat_buffer{}, req);
http::response<http::string_body> res;
handle_request(req, res);
http::write(socket, res);
}
}
为什么不用 libmicrohttpd 或 cpp-httplib
它们能用，但各有硬伤：
-
libmicrohttpd是 C 接口，C++ 里要手动管理MHD_Daemon*、回调函数绑定、内存生命周期，错误码全靠MHD_NO/MHD_YES，调试时看不到具体失败原因 -
cpp-httplib简单易上手，但默认是阻塞式单线程模型；开多线程需自己配ThreadPool，且不支持 HTTP/2、不提供流式 body 解析，上传大文件容易 OOM -
Boost.Beast原生支持异步（async_read/async_write）、SSL、WebSocket、HTTP/2（配合nghttp2），接口统一，错误统一抛boost::system::error_code
http::read() 和 http::async_read() 别混用
同步版 http::read() 会阻塞当前线程直到完整 request 报文收完（含所有 chunk），适合原型验证；但生产环境必须用异步——否则一个慢连接就卡住整个 accept 循环。
立即学习“C++免费学习笔记（深入）”；
关键区别：
- 同步调用后，
req已完全解析，req.method()、req.target()、req.body()都可直接访问 - 异步调用需传入 completion handler，且必须确保
buffer（如flat_buffer）生命周期长于 async 操作，否则读到一半 buffer 被析构，程序崩溃 - 异步模式下，不能在 handler 里直接
http::write()，得先async_write()，否则可能 write 调用时 socket 已关闭
路由和 POST body 解析得自己补，Beast 不提供
Boost.Beast 是协议栈，不是 Web 框架。它不解析 POST /api/user 中的 /api/user，也不自动 decode application/x-www-form-urlencoded 或 parse JSON body。
常见做法：
- 用
req.target()手动字符串匹配（适合简单 REST） - 对
req.body()，检查req[http::field::content_type]，再按类型处理：text/plain直接当字符串；application/json交给nlohmann::json；multipart/form-data得用boost::beast::http::parser分段解析 - 注意：body 可能为空（GET 请求），也可能是流式传输（chunked），别假设
req.body().size() > 0就安全
真正难的从来不是“怎么监听端口”，而是“怎么让服务器在并发 1000 连接、混合 GET/POST/PUT、带 gzip 和 TLS 的情况下不出错”。这些边界 case，Boost.Beast 已经替你踩过坑；你只需要专注业务逻辑，而不是重写一遍 RFC 7230。
