必须同时设置 CURLOPT_POSTFIELDS 和 Content-Type 头，显式指定 POSTFIELDSIZE，用 nlohmann/json 生成合法 UTF-8 JSON，及时调用 curl_slist_free_all 释放头链表，并检查 HTTP 状态码与响应体内容。
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);
注意：CURLOPT_POSTFIELDSIZE 推荐显式设置，避免 JSON 字符串含嵌入 \0 导致截断；curl_slist_append 返回新链表头，不能忽略赋值。
JSON 字符串必须是 UTF-8 编码且无控制字符
cURL 不做编码转换，如果用 std::string 拼接中文或特殊符号后直接传入 CURLOPT_POSTFIELDS，而源字符串实际是 GBK 或含 \r\n\t 等未转义字符，服务端解析会报 400 Bad Request 或 invalid JSON。
立即学习“C++免费学习笔记（深入）”；
安全做法：
- 用成熟 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。
父母的功课——育儿心理学对话支持技能（心虫增强版）。提供结构化对话、情绪识别、场景匹配与安全检测；可选Python脚本（scripts/）在SKILL_DIR/data/本地存储评估历史、洞察与会话状态，不对外传输。核心路径：觉察（看见防御）→接纳（慈悲是……
典型错误写法：
// ❌ 错误：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);
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 不管。
