c++如何使用CURL实现文件上传功能_c++ HTTP表单提交与进度回调【实战】_技术教程

必须设置CURLOPT_HTTPPOST并配合curl_formadd构建表单链表，禁用CURLOPT_POST和CURLOPT_UPLOAD，使用CURLOPT_XFERINFOFUNCTION而非已废弃的CURLOPT_PROGRESSFUNCTION，并在上传后调用curl_formfree释放内存。

curl_easy_setopt 上传文件必须设置 `CURLOPT_HTTPPOST`

直接调用 curl_easy_perform 不会自动触发 multipart/form-data 提交，必须显式启用表单上传模式。常见错误是只设了 URL 和 POST 字段，却漏掉这个关键开关，导致服务端收不到文件字段。

实操要点：

CURLOPT_HTTPPOST 的值必须是 struct curl_httppost * 类型指针，不能传 NULL 或整数
必须配合 curl_formadd 构建表单链表，每调用一次添加一个字段（文本或文件）
上传文件时， CURLFORM_COPYNAME 指定表单项名（如 "file"），CURLFORM_FILE 指定本地路径（如 "./report.pdf"）
如果要同时提交文本字段（如 "username"），用 CURLFORM_COPYCONTENTS，不要混用 CURLFORM_FILE

进度回调要用 `CURLOPT_XFERINFOFUNCTION` 而非 `CURLOPT_PROGRESSFUNCTION`

CURLOPT_PROGRESSFUNCTION 在 libcurl 7.32.0 后已标记为 deprecated，新代码必须用 CURLOPT_XFERINFOFUNCTION，否则编译可能警告，运行时回调不触发。

关键区别：

XFERINFOFUNCTION 回调原型是 int (*func)(void *, curl_off_t, curl_off_t, curl_off_t, curl_off_t)，后四个参数分别是：已上传字节数、总上传大小、已下载字节数、总下载大小
上传场景下只看前两个参数：dl_total 通常为 0，ul_total 是文件大小，ul_now 是当前已发字节数
必须返回 0 表示继续传输；返回非零值（如 1）会中止上传
需额外设置 CURLOPT_XFERINFODATA 传入用户数据指针（比如指向自定义结构体的 void*）

上传大文件前务必设 `CURLOPT_UPLOAD` 为 `0L` 并禁用 `CURLOPT_POST`

很多初学者误以为 CURLOPT_POST = 1L 就能上传，结果服务端收到空 body 或 400 错误。multipart 上传本质是 PUT/POST 请求体构造问题，不是简单开关 POST。

正确做法：

确保 CURLOPT_POST 是 0L（默认值），否则 libcurl 会强制使用 POST 方法并忽略 CURLOPT_HTTPPOST 配置
CURLOPT_UPLOAD 也必须是 0L —— 它用于纯上传（如 FTP PUT），和 HTTP 表单无关，设成 1L 会导致请求体格式错乱
真正控制方法的是 CURLOPT_CUSTOMREQUEST（可选，默认 POST）和 CURLOPT_HTTPPOST（必设）
若服务端要求 PUT 方法，设 CURLOPT_CUSTOMREQUEST 为 "PUT"，但仍需保留 CURLOPT_HTTPPOST

内存泄漏风险：必须调用 `curl_formfree` 清理 `curl_httppost` 链表

每次用 curl_formadd 构造表单都会在堆上分配内存，libcurl 不自动释放。忘记调用 curl_formfree 会导致稳定内存泄漏，尤其在循环上传场景下几秒就崩。

安全写法示例：

struct curl_httppost *formpost = nullptr;
struct curl_httppost *lastptr = nullptr;

curl_formadd(&formpost, &lastptr,
             CURLFORM_COPYNAME, "file",
             CURLFORM_FILE, "./data.bin",
             CURLFORM_END);

curl_formadd(&formpost, &lastptr,
             CURLFORM_COPYNAME, "desc",
             CURLFORM_COPYCONTENTS, "backup",
             CURLFORM_END);

// ... 设置其他选项，执行上传 ...

curl_formfree(formpost); // 必须！

注意：formpost 是链表头指针，传给 curl_formfree 即可，不用遍历释放每个节点。

容易被忽略的一点：如果 curl_formadd 中某次调用失败（返回非 CURLE_OK），formpost 可能部分初始化，此时仍应调用 curl_formfree —— 它能安全处理空指针或半截链表。