用libcurl发起GET请求是最直接的选择:需链接库(-lcurl或libcurl.lib),流程为初始化→设CURLOPT_URL、CURLOPT_FOLLOWLOCATION、CURLOPT_TIMEOUT、CURLOPT_WRITEFUNCTION/WRITEDATA→执行→清理,缺一不可。

用 libcurl 发起 GET 请求是最直接的选择
标准 C++ 没有内置 HTTP 客户端,libcurl 是跨平台、稳定、被广泛验证的方案。它不是头文件库,需要链接动态/静态库,但封装足够轻量,适合“简单请求”场景。
常见错误是只 #include <curl></curl> 却没链接 -lcurl(Linux/macOS)或没配置好 Windows 的 libcurl.lib,编译会报 undefined reference to 'curl_easy_init' 一类符号错误。
基础流程固定:初始化 → 设置选项 → 执行 → 清理。关键参数必须设全,否则可能静默失败或超时:
-
curl_easy_setopt(curl, CURLOPT_URL, "https://httpbin.org/get")—— URL 必须带协议前缀,"httpbin.org/get"会失败 -
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L)—— 不加这个,302 重定向会停住,返回空响应 -
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L)—— 强烈建议设超时,否则 DNS 卡住可能阻塞几十秒 -
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback)和CURLOPT_WRITEDATA—— 用于捕获响应体,不能省略
写一个安全的响应体接收回调函数
很多人直接用 std::string* 当 userptr,然后在回调里 str->append(ptr, size * nmemb),这看似简单,但容易忽略两个问题:一是 size * nmemb 才是真实字节数(size 是每个块大小,nmemb 是块数),二是回调可能被多次调用,必须确保字符串拼接线程安全(单次请求下无并发,但逻辑要自洽)。
立即学习“C++免费学习笔记(深入)”;
更稳妥的做法是用 std::vector<char></char> 接收原始字节,最后转 std::string:
size_t write_callback(void* ptr, size_t size, size_t nmemb, void* userp) {
std::vector<char>* buffer = static_cast<std::vector<char>*>(userp);
size_t real_size = size * nmemb;
buffer->insert(buffer->end(), static_cast<char*>(ptr), static_cast<char*>(ptr) + real_size);
return real_size;
}
调用时传入栈上 std::vector<char> response_data</char>,执行完再做 std::string(response_data.begin(), response_data.end())。这样避免了内存管理出错,也兼容二进制响应(比如下载图片)。
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
POST 请求发 JSON 要手动设置 Content-Type 和数据指针
libcurl 不会自动识别你传的是 JSON,也不会帮你序列化。如果你写 curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{\"key\":\"val\"}") 却忘了设 Content-Type,服务端大概率当成 application/x-www-form-urlencoded 处理,导致解析失败。
正确组合是:
-
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_str.c_str())—— 注意传c_str(),不是std::string对象本身 -
curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, json_str.length())—— 必须显式告诉长度,否则 libcurl 可能读到内部 \0 就停 -
struct curl_slist* headers = nullptr;headers = curl_slist_append(headers, "Content-Type: application/json");curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
用完记得 curl_slist_free_all(headers),否则内存泄漏。如果 POST 数据是二进制或含 null 字节,必须用 CURLOPT_POSTFIELDSIZE,不能依赖 \0 结尾。
Windows 下启用 HTTPS 需要额外处理证书验证
在 Linux/macOS 上,libcurl 通常默认信任系统 CA;但 Windows 默认不加载根证书,直接发 HTTPS 请求会报错:CURLE_SSL_CACERT 或 CURLE_PEER_FAILED_VERIFICATION。
有两个可行路径:
- 最简方式:关闭证书验证(仅限开发或内网)——
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L)和CURLOPT_SSL_VERIFYHOST, 0L。线上环境禁止使用 - 生产推荐:用
CURLOPT_CAINFO指向一个 PEM 格式证书包,例如 Mozilla 的cacert.pem,路径必须是绝对路径或确保运行时可访问
注意 CURLOPT_SSL_VERIFYPEER 和 CURLOPT_SSL_VERIFYHOST 是独立开关,关一个不够,必须都关才跳过验证。而 CURLOPT_CAINFO 的路径如果写错或文件不可读,错误信息不会直接提示“证书文件没找到”,而是继续报证书验证失败,容易误判。

















