cpp-httplib 是最轻量零依赖的 c++ http 库，只需包含头文件并定义 cpphttplib_compile_cpp11 宏、链接 -lpthread 即可运行；默认单线程，qps 200~500，适合内网工具与调试接口。
用 cpp-httplib 最快跑通一个 HTTP 服务
直接上手不折腾，cpp-httplib 是 C++ 里最轻量、零依赖的选项。它把 socket、HTTP 解析、路由都封装好了，编译进项目只要加一个头文件。
常见错误现象：编译报 undefined reference to 'httplib::Server::listen' —— 忘了定义 CPPHTTPLIB_COMPILE_CPP11 宏，或没链接 -lpthread（linux/macos 下必须）。
- 使用场景：内网工具服务、配置页、调试接口，不需要高并发（
cpp-httplib默认单线程，QPS 200~500 左右） - 参数差异：
Server::listen("0.0.0.0", 8080)绑定所有地址，但 windows 上若提示“permission denied”，试试换"127.0.0.1" - 性能影响：开启
server.set_read_timeout(5)和set_write_timeout(5)防止客户端假死拖住线程
简短示例：
#include "httplib.h" int main() { httplib::Server svr; svr.Get("/hello", [](const auto& req, auto& res) { res.set_content("Hello, world!", "text/plain"); }); svr.listen("localhost", 8080); }asio 实现 HTTP 服务器要自己搭轮子
asio 不是 HTTP 库，它是异步 I/O 框架。想用它写 HTTP 服务，得自己处理 TCP 连接、HTTP 报文解析、状态机、keep-alive、chunked 编码……工作量远超预期。
立即学习“C++免费学习笔记（深入）”；
容易踩的坑：直接照抄 asio 的 http_server 示例（boost.org 官方那个），会发现它只支持 HTTP/1.0、不处理 POST body、无法复用连接——这些在真实场景里全得补。
- 使用场景：已有 asio 基础设施、需要和 udp/ssl/自定义协议共存、或明确要控制每个字节的收发逻辑
- 参数差异：
asio::ip::tcp::acceptor构造时传asio::ip::tcp::v4()明确指定 IPv4，否则某些系统默认走 IPv6，监听不到127.0.0.1 - 兼容性影响：asio 1.22+ 要求 C++17，旧项目若用 C++14，得锁死在 1.20.x 版本
POST 请求体读取失败？注意 body 大小和编码
cpp-httplib 默认限制 body 最大为 1MB，超限就静默截断，req.body 变空，但不会报错——这是最常被忽略的点。
常见错误现象：前端发 json，后端收到空 req.body，检查 header 有 Content-Type: application/json，但就是拿不到数据。
- 解决方法：构造
Server后立刻调用svr.set_payload_max_size(10 * 1024 * 1024)（比如设 10MB） - 如果前端用
multipart/form-data，cpp-httplib不解析，得手动 parse boundary 和字段——这时候建议换crow或直接上 Python - 注意：
req.body是 raw 字节流，不是自动 UTF-8 解码后的字符串，中文需自行处理编码
部署时端口被占或无法外网访问
本地能跑不代表上线能用。cpp-httplib 默认 listen "0.0.0.0"，但 Linux 上非 root 进程不能绑定 1024 以下端口；云服务器则大概率默认关闭非 80/443 端口的入站规则。
- 快速验证：用
curl -v http://localhost:8080/hello成功，但换成本机 IP 就超时 → 防火墙或云平台安全组没开 - 避免权限问题：开发阶段用 8080、8081 这类高位端口，上线再配反向代理（nginx 转发到 8080）
- asioserver 如果用
server.run()启动后立即返回，其实是后台线程在跑——别误以为进程退出了
复杂点往往不在协议实现，而在边界条件：超时怎么设、body 多大算合理、并发连接数是否真够用、日志有没有漏掉 client IP。这些没法靠库自动兜底。