用libcurl发起HTTP请求是最直接方案，需正确初始化、设置选项、捕获响应、解析JSON并分层处理网络/HTTP/业务错误。
用 libcurl 发起 HTTP 请求是最直接的方案
标准 C++ 没有内置 HTTP 客户端，libcurl 是跨平台、稳定、生产可用的选择。它不依赖 Boost 或现代 C++20 特性，Windows/macOS/Linux 都能快速编译接入。
常见错误是直接用 std::system("curl ...")：不可控、难调试、无法捕获响应体、无法处理重定向或超时。必须用 libcurl 的 C API 封装调用。
实操建议：
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- Windows 下推荐用 vcpkg 安装：
vcpkg install curl:x64-windows；macOS 用brew install curl；Linux 用sudo apt install libcurl4-openssl-dev - 初始化必须调用
curl_global_init(CURL_GLOBAL_DEFAULT)，且只需一次（通常在 main 开头） - 每个请求应创建独立的
CURL*句柄，设置CURLOPT_URL、CURLOPT_HTTPGET、CURLOPT_TIMEOUT等关键选项 - 用
CURLOPT_WRITEFUNCTION+CURLOPT_WRITEDATA捕获响应体到std::string，而非依赖CURLOPT_HEADER或 stdout 重定向
用 nlohmann/json 解析 JSON 响应最省心
手动解析 JSON 字符串容易出错（如嵌套对象越界、类型误判、编码问题），nlohmann/json 是 header-only 库，支持直接从 std::string 构造，语法接近 Python。
立即学习“C++免费学习笔记（深入）”；
典型陷阱是忽略返回值校验：API 返回 200 但 body 是 {"error":"not found"}，或字段缺失导致 json["data"]["items"] 报 out_of_range 异常。
实操建议：
- 始终用
try { json j = json::parse(response_str); } catch (const json::parse_error&) { /* 处理非法 JSON */ } - 访问嵌套字段前检查存在性：
if (j.contains("data") && j["data"].is_object()) { ... } - 用
j.value("count", 0)提供默认值，避免j["count"].get<int>()</int>在字段不存在时抛异常 - 若 API 返回数组，用
for (const auto& item : j["items"]) { ... }迭代，别硬写j["items"][i]循环
HTTP 错误码和网络异常必须显式处理
很多代码只检查 curl_easy_perform() 返回值是否为 CURLE_OK，却忽略 HTTP 状态码（如 401、404、503）。libcurl 默认不把非 2xx 当作错误，需手动读取 CURLINFO_RESPONSE_CODE。
更隐蔽的问题是 DNS 失败、连接超时、SSL 证书验证失败——这些会触发 CURLE_COULDNT_RESOLVE_HOST 等错误，但不会产生有效 JSON 响应。
实操建议：
- 调用
curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &http_code)获取真实状态码，再判断是否在 200–299 范围 - 设置
CURLOPT_FAILONERROR为 1L 可让 libcurl 对 4xx/5xx 自动返回错误（但注意：某些 API 用 400 表示业务失败，此时不该中断） - 务必设置
CURLOPT_CONNECTTIMEOUT和CURLOPT_TIMEOUT，否则默认无超时，卡死在线程里 - SSL 场景下，开发期可设
CURLOPT_SSL_VERIFYPEER为 0L（跳过证书验证），但上线必须恢复为 1L 并配好 CA bundle 路径（CURLOPT_CAINFO）
完整最小可运行示例（含错误防护）
以下代码片段整合了上述要点，仅依赖 libcurl 和 nlohmann/json，无额外封装：
#include <iostream>
#include <string>
#include <curl/curl.h>
#include <nlohmann/json.hpp><p>size_t write_callback(void<em> ptr, size_t size, size_t nmemb, std::string</em> data) {
size_t real_size = size <em> nmemb;
data->append((char</em>)ptr, real_size);
return real_size;
}</p><p>int main() {
curl_global_init(CURL_GLOBAL_DEFAULT);
CURL* curl = curl_easy_init();
if (!curl) return -1;</p><pre class='brush:php;toolbar:false;'>std::string response;
curl_easy_setopt(curl, CURLOPT_URL, "https://httpbin.org/get");
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
CURLcode res = curl_easy_perform(curl);
long http_code = 0;
curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &http_code);
curl_easy_cleanup(curl);
curl_global_cleanup();
if (res != CURLE_OK || http_code < 200 || http_code >= 300) {
std::cerr << "HTTP error: " << curl_easy_strerror(res) << ", code=" << http_code << "\n";
return -1;
}
try {
nlohmann::json j = nlohmann::json::parse(response);
std::cout << "Origin: " << j.value("origin", "unknown") << "\n";
} catch (const nlohmann::json::parse_error& e) {
std::cerr << "JSON parse error at byte " << e.byte << ": " << e.what() << "\n";
return -1;
}
return 0;}
真正复杂的地方不在调用本身，而在于如何区分网络层失败、HTTP 层失败、业务逻辑失败——这三类错误需要不同策略（重试、告警、用户提示），但很多人只写了一个 if (res != CURLE_OK) 就以为搞定了。
