libcurl原生支持multipart/form-data，推荐使用7.56.0+版本的curl_mime_*接口构造请求体，自动处理边界、编码及头字段，避免手拼错误；需校验返回码、确认文件可读、正确设置name/filename/type，禁用手动Content-Type。
用 libcurl 发起 multipart/form-data POST 请求
直接用 C++ 标准库没法发 HTTP，必须依赖第三方库。libcurl 是最稳妥的选择，它原生支持 multipart/form-data 编码，能正确处理二进制边界、Content-Transfer-Encoding 和文件头字段。
关键不是“怎么发 POST”，而是“怎么构造 multipart body”——手拼容易出错（比如边界符重复、换行符不一致、缺少空行），libcurl 的 curl_mime_init() 和 curl_mime_addpart() 就是专为这事设计的，比老式 curl_formadd() 更清晰、更可控。
- 必须用 libcurl 7.56.0+，低版本不支持
curl_mime_*系列 API -
curl_mime_addpart()返回的CURLcode要检查，尤其CURLE_OUT_OF_MEMORY或CURLE_BAD_FUNCTION_ARGUMENT很常见 - 文件路径传给
curl_mime_filedata()前，务必确认文件存在且可读，否则请求体为空但 curl 不报错
设置 Content-Type 和 boundary 的陷阱
别手动设置 Content-Type: multipart/form-data —— libcurl 会自动加，且附带生成的 boundary=...。如果自己用 curl_slist_append() 硬塞，反而会导致服务端解析失败（重复 boundary、格式错乱）。
真正要管的是：上传字段名（name="file"）、文件名（filename="photo.jpg"）、MIME 类型（Content-Type: image/jpeg）。这些由 curl_mime_name()、curl_mime_filename()、curl_mime_type() 控制，顺序不能颠倒。
立即学习“C++免费学习笔记（深入）”；
- 调用
curl_mime_filename()后，libcurl 才会在 part 头里写filename="..."；漏掉这步，服务端收到的就是无名二进制流 - 没设
curl_mime_type()时，libcurl 默认用application/octet-stream，某些后端（如 Django 的request.FILES）可能拒绝识别 - boundary 全局唯一，libcurl 自动管理，别试图从 header 里提取或复用——它只在请求发送瞬间有效
内存中二进制数据怎么上传（不走磁盘文件）
如果数据来自内存（比如加密后的 buffer、摄像头帧），不能用 curl_mime_filedata()，得用 curl_mime_data() + curl_mime_data_cb()。
最简方案是 curl_mime_data()：把整个 buffer 一次性传进去，适合小文件（sizeof(ptr)，且 buffer 生命周期必须覆盖整个 curl_easy_perform() 过程。
- 大 buffer 直接传会触发内存拷贝，性能差；这时该用
curl_mime_data_cb()注册回调，让 libcurl 按需拉取数据块 - 回调函数签名必须是
size_t (*readfunc)(char *ptr, size_t size, size_t nmemb, void *userdata)，返回实际复制的字节数，不是size*nmemb - 别在回调里做耗时操作（如解密、网络请求），libcurl 是同步调用，卡住就超时
常见错误现象和调试方法
上传失败时，服务端通常只返回 400 或 500，看不出具体哪错了。得靠 libcurl 自身日志定位：
- 开启 verbose 模式：
curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L)，看实际发出的请求头和 body 结构 - 抓包验证：Wireshark 过滤
http.request.method == "POST"，重点查 boundary 是否匹配、每个 part 是否有空行、最后一行是否是--boundary-- - 典型错误：
curl_mime_filename()没设 → 服务端收到Content-Disposition: form-data; name="file"（缺 filename）→ 解析成普通表单字段而非文件 - 另一个坑：
curl_easy_setopt(curl, CURLOPT_POST, 1L)必须配curl_easy_setopt(curl, CURLOPT_MIMEPOST, mime)，单独设 POST 不生效
multipart 的细节容错率低，少一个换行、多一个空格、boundary 写错一位，服务端就拒收。与其反复试，不如先用 curl 命令行验证通路：curl -F "file=@test.bin" http://localhost:8000/upload，再对照 C++ 代码逐行比对。
