C++如何实现简单的HTTP请求-C++-PHP中文网

用libcurl发起get请求是最直接的选择：需链接库（-lcurl或libcurl.lib），流程为初始化→设curlopt_url、curlopt_followlocation、curlopt_timeout、curlopt_writefunction/writedata→执行→清理，缺一不可。

c++如何实现简单的http请求

用 `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 是块数），二是回调可能被多次调用，必须确保字符串拼接线程安全（单次请求下无并发，但逻辑要自洽）。

更稳妥的做法是用 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<:vector>*>(userp);
    size_t real_size = size * nmemb;
    buffer->insert(buffer->end(), static_cast<char>(ptr), static_cast<char>(ptr) + real_size);
    return real_size;
}
</char></char></:vector></char>

调用时传入栈上 std::vector<char> response_data</char>，执行完再做 std::string(response_data.begin(), response_data.end())。这样避免了内存管理出错，也兼容二进制响应（比如下载图片）。

C++ Code Review Master

组合式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 的路径如果写错或文件不可读，错误信息不会直接提示“证书文件没找到”，而是继续报证书验证失败，容易误判。