mongoose最合适——单文件、无依赖、支持静态网页与post表单、内存占用低于100kb，仅需基础posix接口，适配freertos等嵌入式环境。
用什么轻量级库最合适？选 mongoose 而不是 libmicrohttpd 或 cpp-httplib
嵌入式设备资源紧张，C++ Web 服务器必须满足：单文件、无依赖、支持静态网页、能处理 POST 表单、内存占用低于 100KB。mongoose 是唯一满足全部条件的成熟选择——它把整个 HTTP/HTTPS/WS 实现压缩在 mongoose.h + mongoose.c 两个文件里，编译后代码段不到 60KB（ARM Cortex-M4 + FreeRTOS 下实测），且原生支持 URL 路由、表单解析、静态文件服务。
libmicrohttpd 依赖 GNU TLS 和 libgcrypt，交叉编译链容易断裂；cpp-httplib 是纯头文件但基于 C++11 线程和 STL 容器，在裸机或 RTOS 上无法直接用；而 mongoose 只需 read/write/select 等基础 POSIX 接口，FreeRTOS、Zephyr、ThreadX 甚至裸机加 lwIP 都能适配。
- 别碰
mongoose的 HTTPS 模块——除非你有硬件加密加速器，否则 AES/SHA 在 Cortex-M3 上会卡死连接 - 默认关闭 WebSocket 支持（注释掉
#define MG_ENABLE_WS），省下约 8KB 代码空间 - 静态网页建议放 SPI Flash 或 QSPI NOR 中，用
mg_http_serve_file()直接 mmap 映射，避免 RAM 加载整页 HTML
怎么解析浏览器发来的配置参数？用 mg_http_get_var() 而不是手写 strstr 解析
浏览器提交表单时，数据是 application/x-www-form-urlencoded 格式（如 temp_set=25&fan_mode=auto），手动用 strstr 拆解极易漏掉 URL 编码字符（空格变 +、中文变 %E4%BD%A0）。mongoose 提供 mg_http_get_var() 直接解码并提取值，安全可靠。
关键点：该函数只对当前请求的 body 生效，所以必须在 MG_EV_HTTP_MSG 事件里调用，且要先确认 hm->body.len > 0（GET 请求无 body，参数在 URL query 里，得用 mg_url_decode() 先拆）。
- POST 表单：检查
hm->method == MG_HTTP_METHOD_POST，再用mg_http_get_var(&hm->body, "temp_set", buf, sizeof(buf)) - GET 参数：先用
mg_url_decode(hm->uri.ptr, hm->uri.len, uri_decoded, sizeof(uri_decoded), 0)，再传给mg_http_get_var() - 数值校验必须自己做——
mg_http_get_var()返回的是字符串，atoi()前要判断是否为空或含非法字符
怎么让网页实时显示设备状态？用 Server-Sent Events (SSE) 而不是轮询或 WebSocket
浏览器需要每秒刷新温度、电压等状态，但 WebSocket 在嵌入式端开销大（每个连接占 2KB+ RAM），HTTP 轮询又浪费带宽。SSE 是单向流式协议：浏览器用 EventSource 连接一个固定 URL（如 /status），服务器持续推送 data: {"vcc":3.28,"temp":24.7}\n\n，天然适合嵌入式只发不收的场景。
mongoose 本身不内置 SSE 封装，但只需三步：设置响应头（mg_printf(c, "HTTP/1.1 200 OK\r\nContent-Type: text/event-stream\r\nCache-Control: no-cache\r\nConnection: keep-alive\r\n\r\n")）、<strong>循环发送 data 行</strong>（注意结尾两个换行符）、<strong>每次发送后调用 <code>mg_sock_send() 强制刷出缓冲区（否则数据卡在 TCP 发送队列里）。
- SSE 连接默认 30 秒超时，浏览器会自动重连，无需客户端写重连逻辑
- 避免在 SSE 处理中调用阻塞操作（如 I2C 读传感器）——用定时器触发状态采集，SSE 回调只负责发缓存值
- 每个 SSE 连接独占一个 socket，连接数超过 5 个时，务必检查
MG_CFG_MAX_OPEN_SOCKS是否足够（默认 10，可改）
为什么网页总打不开或参数不生效？重点查这三处
实际调试中最常卡在这三个地方，和代码逻辑无关，纯属环境或配置疏漏：
- 网页 JS 里访问
/api/config时被浏览器同源策略拦截——确保服务器返回的Access-Control-Allow-Origin: *响应头（用mg_printf(c, "Access-Control-Allow-Origin: *\r\n")） - 设备 IP 改变后浏览器仍缓存旧 DNS 或 HSTS 记录——强制用
http://192.168.1.100（而非http://device.local）测试，禁用浏览器预加载（Chrome 地址栏输chrome://net-internals/#hsts删除） - 修改参数后设备未保存到 Flash——
mg_http_get_var()拿到值只是第一步，后续必须调用你的 Flash 写函数（如flash_write_page()），且要等写完成中断后再返回 HTTP 响应，否则浏览器收到 200 但实际没存上
最易被忽略的是：所有 HTTP 响应体末尾必须有 \r\n\r\n（空行），少一个 \r 就会导致浏览器一直转圈等待响应结束——这是纯文本协议的硬性要求，不是风格问题。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
