选Mongoose因它轻量无依赖、线程安全，避免重复造轮子；最简HTTP服务需mg_mgr_init→mg_http_listen→mg_mgr_poll循环；注意URL带协议、回调事件类型非状态码、mgr不能局部声明。
为什么选 Mongoose 而不是自己写 socket
因为 socket、select、epoll 这套轮子重复造起来成本高，边界情况多（比如半包、连接异常中断、HTTP 头解析错误），而 Mongoose 是个轻量 C 库，单头文件、无依赖、线程安全，适合嵌入式或快速原型。它不追求功能全，但把 GET/POST、静态文件服务、基本路由这几件事做稳了。
最简 HTTP 服务跑起来要哪几步
核心就是初始化 + 注册回调 + 进入事件循环。Mongoose 不开新线程，靠 mg_http_listen 创建监听句柄，再用 mg_mgr_poll 主动轮询。
-
struct mg_mgr mgr必须在栈或全局声明，不能局部自动变量（内部会存指针） -
mg_http_listen(&mgr, "http://0.0.0.0:8000", fn, &user_data)中的 URL 字符串必须带协议前缀，否则静默失败 - 回调函数
fn类型是void (*fn)(struct mg_connection *, int, void *)，第二个参数是MG_EV_HTTP_MSG等事件类型，不是 HTTP 状态码 - 别忘了调
mg_mgr_init(&mgr)和mg_mgr_free(&mgr)，否则内存泄漏
示例骨架：
#include "mongoose.h"
void fn(struct mg_connection *c, int ev, void *ev_data) {
if (ev == MG_EV_HTTP_MSG) {
struct mg_http_message *hm = (struct mg_http_message *) ev_data;
mg_http_reply(c, 200, "", "OK\n");
}
}
int main() {
struct mg_mgr mgr;
mg_mgr_init(&mgr);
mg_http_listen(&mgr, "http://0.0.0.0:8000", fn, NULL);
for (;;) mg_mgr_poll(&mgr, 1000); // 毫秒超时
mg_mgr_free(&mgr);
}
处理 POST 数据和表单字段的坑
Mongoose 不自动解析 application/x-www-form-urlencoded 或 multipart/form-data，得自己动手。常见错误是直接读 hm->body 但没考虑编码、边界、空格转义。
立即学习“C++免费学习笔记（深入）”；
- 对简单键值对，用
mg_http_get_var：比如mg_http_get_var(&hm->body, "name", buf, sizeof(buf)) - 注意
buf长度含结尾\0，传sizeof(buf)-1更安全 - 上传文件时，
multipart需要手动找boundary并切分段——Mongoose 提供mg_http_get_multipart辅助，但不封装完整解析逻辑 - 大文件上传别一次性读进内存，要用
MG_EV_READ分块收，配合c->data存状态
静态文件服务怎么配才不 404
不是加个 mg_http_serve_dir 就完事。路径、权限、MIME 类型都可能出问题。
-
mg_http_serve_dir(c, hm, "/path/to/www", "/index.html")第二个参数是默认页，不是根目录 - 路径必须是绝对路径或相对于当前工作目录；若程序 daemon 化，工作目录可能不是你预期的
- 确保目录有可读权限，Linux 下还可能被 SELinux 拦住（
ls -Z看上下文） - 默认 MIME 表有限，遇到
.webp或.wasm会返回text/plain，需调mg_http_serve_opts手动扩展extra_mime_types
容易被忽略的是：Mongoose 的静态服务不支持目录遍历防护以外的访问控制，.. 会被自动过滤，但如果你自己拼接路径，就可能绕过。
