C++如何使用cURL库发送POST JSON请求-C++-PHP中文网

必须同时设置 curlopt_postfields 和 content-type 头，显式指定 postfieldsize，用 nlohmann/json 生成合法 utf-8 json，及时调用 curl_slist_free_all 释放头链表，并检查 http 状态码与响应体内容。

c++如何使用curl库发送post json请求

curl_easy_setopt 设置 POST 数据和头信息必须成对出现

不设置 CURLOPT_POSTFIELDS 却只加 Content-Type: application/json 头，cURL 会默认发 GET 请求，后端收不到 body。反过来，只传 CURLOPT_POSTFIELDS 不设头，某些服务（如 FastAPI、Spring Boot）会因 Content-Type 缺失直接拒收或解析失败。

正确做法是两者同步配置：

curl_easy_setopt(curl, CURLOPT_URL, "https://api.example.com/data");
curl_easy_setopt(curl, CURLOPT_POST, 1L);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_str.c_str());
curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, json_str.length());
<p>struct curl_slist* headers = nullptr;
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
</p>

注意：CURLOPT_POSTFIELDSIZE 推荐显式设置，避免 JSON 字符串含嵌入 \0 导致截断；curl_slist_append 返回新链表头，不能忽略赋值。

JSON 字符串必须是 UTF-8 编码且无控制字符

cURL 不做编码转换，如果用 std::string 拼接中文或特殊符号后直接传入 CURLOPT_POSTFIELDS，而源字符串实际是 GBK 或含 \r\n\t 等未转义字符，服务端解析会报 400 Bad Request 或 invalid JSON。

安全做法：

用成熟 JSON 库（如 nlohmann/json）生成字符串，它默认输出合法 UTF-8 并自动转义
手拼时确保所有非 ASCII 字符经 UTF-8 编码，且双引号、反斜杠、控制符（\b\f\n\r\t）已转义
发送前可用 std::isprint + static_cast<unsigned char></unsigned> 快速检查是否有非法字节

示例（nlohmann/json）：

json j = {{"name", "张三"}, {"score", 95}};
std::string json_str = j.dump(); // 自动处理编码与转义

忘记调用 curl_slist_free_all 会导致内存泄漏

每次用 curl_slist_append 分配的链表，必须在 curl_easy_cleanup 前手动释放，否则每发一次请求就漏一块内存。这不是“偶尔漏一次没关系”的问题——在长周期服务中几小时就可能吃光几十 MB。

Leaf Curling & Margin Scorch Diagnosis | 植物卷叶/焦边识别（干旱/病害）

利用农业相机拍摄植物叶片高分辨率图像，通过AI视觉技术检测叶片卷曲方向（向上卷曲或向下卷曲）

下载

典型错误写法：

// ❌ 错误：slist 没释放
struct curl_slist* headers = curl_slist_append(nullptr, "Content-Type: application/json");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
// ... 执行请求 ...
curl_easy_cleanup(curl); // headers 仍悬空

正确写法：

struct curl_slist* headers = nullptr;
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
<p>// ... curl_easy_perform ...</p><p>curl_slist_free_all(headers); // ✅ 必须加这一行
curl_easy_cleanup(curl);
</p>

POST 后不检查返回码和响应体容易掩盖真实错误

curl_easy_perform 返回 CURLE_OK 只代表网络层成功（TCP 连上、HTTP 报文发出去并收到响应），不代表业务成功。比如服务端返回 500 Internal Server Error 或 422 Unprocessable Entity，cURL 仍认为“执行成功”。

必须配合 CURLOPT_HEADERFUNCTION 和 CURLOPT_WRITEFUNCTION 捕获状态码与响应体：

long http_code = 0;
curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &http_code);
if (http_code != 200 && http_code != 201) {
    fprintf(stderr, "HTTP error: %ld, response: %s\n", http_code, response_buffer.c_str());
}

同时注意：response_buffer 需提前分配好（如用 std::string 的 .data() + .capacity() 控制），否则接收超长响应会越界。

真正难调试的问题，往往出在 HTTP 状态码是 200 但 JSON 响应里带 "error": "xxx" —— 这类逻辑校验得靠你自己解析响应体，cURL 不管。