用cpp-httplib快速搭建上传服务，避免手写HTTP解析；它自动处理multipart/form-data、支持流式读取和大文件，需注意安全清洗文件名、二进制模式写入及超时设置。
用 cpp-httplib 快速启动上传服务，别自己解析 HTTP 原始字节
直接手写 HTTP 解析（比如读 Content-Length、切分 multipart/form-data boundary）极易出错，且不处理流式上传、大文件、编码边界就崩溃。推荐用成熟轻量库：cpp-httplib —— 单头文件、无依赖、支持 HTTPS，POST 回调里能拿到完整请求体或按需流式读取。
关键点：它把 multipart 表单自动拆成字段和文件项，不用你手动找 --boundary 和换行符。
- 下载
httplib.h到项目目录，#include "httplib.h"即可 - 服务启动只需 3 行：
httplib::Server svr;+svr.Post("/upload", handler)+svr.listen("0.0.0.0", 8080) - 注意：默认只读取前 10MB 请求体，大文件需调用
svr.set_payload_max_length(1024LL * 1024 * 1024);（例如设为 1GB）
multipart/form-data 文件字段怎么安全提取
浏览器表单或 curl -F "file=@xxx.txt" 发来的请求，文件内容在 req.files 里，不是 req.body。必须用 req.has_file("file") 判断存在性，再用 req.get_file_value("file") 拿到结构体。
这个结构体含 .content（内存中的二进制数据）、.filename（客户端传的原始文件名）、.name（表单字段名）。不要直接信任 .filename，它可能含 ../ 或空字节，写磁盘前必须清洗。
立即学习“C++免费学习笔记（深入）”；
- 用
std::filesystem::path构造路径后调用.lexically_normal()并检查是否为相对路径 - 拒绝空 filename 或含非法字符（如
\0、控制字符）的请求，直接返回 400 - 示例清洗逻辑：
auto clean_name = std::regex_replace(orig, std::regex("[^a-zA-Z0-9._-]"), "_");
上传大文件时内存暴涨？用 req.body 流式读取替代全加载
当文件超百 MB，req.get_file_value("file").content 会把整个文件载入内存，极易 OOM。此时应关闭自动解析 multipart，改用原始 body 流式处理。
做法是：在注册路由前调用 svr.set_parse_request_body(false)，然后在 handler 中用 req.body 手动解析 —— 但注意，此时 req.files 为空，所有解析逻辑得自己写。
- 更稳妥的折中方案：仍启用 multipart 解析，但对大文件字段（比如
req.get_file_value("file").content.size() > 50 * 1024 * 1024），立刻用fwrite写临时文件，边读边刷盘，不保留在内存 - 务必设置
req.body读取超时：svr.set_read_timeout(30, 0)，防止客户端慢传卡死连接 - 别忘了检查磁盘空间，
std::filesystem::space()在写入前调用一次
为什么上传后文件损坏？重点检查 Content-Type 和换行符处理
常见现象：图片打不开、PDF 报“truncated”，大概率是写入时用了文本模式（"w"）而非二进制模式（"wb"），尤其在 Windows 上会把 \n 自动转成 \r\n，破坏二进制数据。
另一个坑是：前端用 fetch 发送 Blob 时没设 Content-Type，cpp-httplib 可能误判 multipart boundary，导致截断。必须确保请求带正确 header：Content-Type: multipart/form-data; boundary=----WebKitFormBoundary...
- 写文件一律用
std::ofstream f(path, std::ios::binary)，确认f.is_open() && f.good() - 如果用 C 风格
fopen，必须用"wb"，不能用"w" - 调试时加一句日志：
LOG ，比对是否一致
实际部署时，cpp-httplib 不适合高并发（单线程模型），但作为内部工具、CI 上传节点或原型验证完全够用；真要上线，得上 Boost.Beast 或反向代理到 Nginx 处理静态上传。不过绝大多数场景下，把 boundary 解析、路径清洗、二进制写入这三步做严，就已经比 90% 的 DIY 实现更稳了。
