C++调用libcurl发送HTTP请求需初始化句柄、设置选项、执行请求、处理响应并清理资源；其为C风格API，稳定适合生产环境，支持GET/POST及状态码获取。
用 C++ 调用 libcurl 发送 HTTP 请求，核心是初始化 curl 句柄、设置选项、执行请求、处理响应、清理资源。它不是开箱即用的“类库”，而是 C 风格 API，但封装得清晰稳定，适合生产环境。
1. 安装与基础配置
Linux（如 Ubuntu）直接安装开发包：
sudo apt install libcurl4-openssl-dev
macOS 用 Homebrew：
立即学习“C++免费学习笔记（深入）”；
brew install curl
Windows 推荐用 vcpkg：
vcpkg install curl:x64-windows
然后在 CMakeLists.txt 中链接 curl 库，并确保包含头文件路径。
代码开头必须包含：
#include
2. GET 请求（带超时和错误检查）
这是最常用场景。关键点：必须设置 CURLOPT_URL、CURLOPT_FOLLOWLOCATION（重定向）、CURLOPT_TIMEOUT（防卡死），并提供回调函数接收响应体。
示例代码片段：
static size_t WriteCallback(void* contents, size_t size, size_t nmemb, void* userp) {
size_t realsize = size * nmemb;
std::string* buf = static_cast(userp);
buf->append(static_cast(contents), realsize);
return realsize;
}
std::string httpGet(const std::string& url) {
CURL* curl;
CURLcode res;
std::string response;
curl = curl_easy_init();
if (!curl) return "";
curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);
curl_easy_setopt(curl, CURLOPT_USERAGENT, "cpp-libcurl/1.0");
res = curl_easy_perform(curl);
if (res != CURLE_OK) {
fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
}
curl_easy_cleanup(curl);
return response;}
3. POST 请求（JSON 数据）
发送 JSON 时需手动设置 Content-Type 头，并把 JSON 字符串作为 POST body。注意：libcurl 默认不自动识别 JSON，必须显式设置头和数据指针。
- 用 CURLOPT_POSTFIELDS 传原始字符串（适合小数据）
- 用 CURLOPT_POST 启用 POST 方法（或更推荐 CURLOPT_CUSTOMREQUEST + CURLOPT_POSTFIELDS 组合）
- 用 CURLOPT_HTTPHEADER 添加自定义 header（如 application/json）
示例：
std::string httpPostJson(const std::string& url, const std::string& json) {
CURL* curl;
CURLcode res;
std::string response;
curl = curl_easy_init();
if (!curl) return "";
struct curl_slist* headers = nullptr;
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
curl_easy_setopt(curl, CURLOPT_POST, 1L);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json.c_str());
curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, json.length());
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);
res = curl_easy_perform(curl);
if (res != CURLE_OK) {
fprintf(stderr, "POST failed: %s\n", curl_easy_strerror(res));
}
curl_slist_free_all(headers);
curl_easy_cleanup(curl);
return response;}
4. 处理状态码与常见错误
仅靠 curl_easy_perform() 返回值不够——它只表示网络层是否成功（如 DNS 解析、连接、发送）。要获取 HTTP 状态码（如 404、500），必须调用 curl_easy_getinfo()：
long http_code = 0;
curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &http_code);
if (http_code == 200) {
// 成功
} else if (http_code >= 400) {
// 客户端或服务端错误
}
常见失败原因：
-
CURLE_COULDNT_RESOLVE_HOST：域名解析失败 → 检查网络或 DNS
-
CURLE_COULDNT_CONNECT：无法建立 TCP 连接 → 检查目标地址、端口、防火墙
-
CURLE_OPERATION_TIMEDOUT：超时 → 调大 CURLOPT_TIMEOUT 或检查服务可用性
- 返回空响应但无报错 → 很可能是未设置 CURLOPT_FOLLOWLOCATION 导致 302 重定向被忽略
不复杂但容易忽略。
