使用 C/C++ 调用 libcurl 调试消息
在使用 C/C++ 调用 libcurl 进行 HTTP 请求时，有时我们需要查看请求的/应答消息的内容（包括请求头和请求体）以方便调试。libcurl 提供了多种方法来捕获和输出这些信息，本文介绍具体的使用方式。
1. libcurl 调试工具简介
libcurl 是一个功能强大的库，用于在 C/C++ 中实现 HTTP 请求（支持 GET、POST、PUT 等方法）。为了调试请求和响应信息，libcurl 提供了以下功能：
- 启用详细日志输出： 使用
CURLOPT_VERBOSE打印所有传输信息。 - 自定义调试回调函数： 使用
CURLOPT_DEBUGFUNCTION捕获并处理调试日志。 - 输出请求头和请求体： 使用
CURLINFO_HEADER_OUT和CURLOPT_POSTFIELDS输出完整的请求。 - 捕获响应内容： 使用
CURLOPT_WRITEFUNCTION将服务器响应保存到变量中。
2. 输出请求消息
-
使用
CURLOPT_VERBOSE
CURLOPT_VERBOSE 是最简单的调试工具，通过设置该选项为 1L，可以让 libcurl 输出详细的传输信息，包括请求头和请求体：
curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);
输出内容示例如下：
> POST /api HTTP/1.1
> Host: example.com
> Content-Type: application/json
> Content-Length: 29
>
* upload completely sent off: 29 out of 29 bytes
-
使用
CURLOPT_DEBUGFUNCTION
如果需要对调试信息进行更多控制，可以使用 CURLOPT_DEBUGFUNCTION 自定义处理逻辑，例如将日志保存到文件或字符串中。
以下是自定义调试回调函数的代码：
#include <iostream>
#include <string>
#include <curl/curl.h>int DebugCallback(CURL* handle, curl_infotype type, char* data, size_t size, void* userptr) {std::string* log = static_cast<std::string*>(userptr);if (type == CURLINFO_HEADER_OUT) {log->append("[REQUEST HEADERS]:\n");log->append(data, size);} else if (type == CURLINFO_DATA_OUT) {log->append("[REQUEST BODY]:\n");log->append(data, size);}return 0;
}
3. 输出响应消息
为了捕获服务器的响应，可以使用 CURLOPT_WRITEFUNCTION 将响应保存到变量中：
size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* userp) {size_t totalSize = size * nmemb;userp->append((char*)contents, totalSize);return totalSize;
}
在配置 CURL 选项时，添加：
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &responseString);
4. 完整代码示例
以下是一个完整的示例，展示如何使用 libcurl 发送 HTTPS POST 请求，并输出请求和响应的详细信息。
#include <iostream>
#include <string>
#include <curl/curl.h>// 自定义调试回调函数
int DebugCallback(CURL* handle, curl_infotype type, char* data, size_t size, void* userptr) {std::string* log = static_cast<std::string*>(userptr);if (type == CURLINFO_HEADER_OUT) {log->append("[REQUEST HEADERS]:\n");log->append(data, size);} else if (type == CURLINFO_DATA_OUT) {log->append("[REQUEST BODY]:\n");log->append(data, size);}return 0;
}// 回调函数：接收服务器的响应数据
size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* userp) {size_t totalSize = size * nmemb;userp->append((char*)contents, totalSize);return totalSize;
}int main() {CURL* curl = curl_easy_init();if (!curl) {std::cerr << "Failed to initialize CURL!" << std::endl;return 1;}const std::string url = "https://example.com/api";const std::string jsonData = R"({"key1":"value1", "key2":"value2"})";std::string responseString;std::string debugLog; // 用于存储调试日志struct curl_slist* headers = nullptr;headers = curl_slist_append(headers, "Content-Type: application/json");// 设置 CURL 选项curl_easy_setopt(curl, CURLOPT_URL, url.c_str());curl_easy_setopt(curl, CURLOPT_POST, 1L);curl_easy_setopt(curl, CURLOPT_POSTFIELDS, jsonData.c_str());curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);curl_easy_setopt(curl, CURLOPT_WRITEDATA, &responseString);// 启用调试功能curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);curl_easy_setopt(curl, CURLOPT_DEBUGFUNCTION, DebugCallback);curl_easy_setopt(curl, CURLOPT_DEBUGDATA, &debugLog);// 执行请求CURLcode res = curl_easy_perform(curl);if (res != CURLE_OK) {std::cerr << "CURL error: " << curl_easy_strerror(res) << std::endl;} else {std::cout << "Response: " << responseString << std::endl;}// 输出调试日志std::cout << "\n===== Debug Log =====\n" << debugLog << std::endl;curl_easy_cleanup(curl);curl_slist_free_all(headers);return 0;
}
5. 编译和运行
-
确保已安装
libcurl。 在 Ubuntu 上安装：sudo apt-get install libcurl4-openssl-dev -
使用以下命令编译代码：
g++ -o post_debug post_debug.cpp -lcurl -
运行程序：
./post_debug
6. 输出示例
程序运行后，会输出请求和响应信息，例如：
调试日志
===== Debug Log =====
[REQUEST HEADERS]:
POST /api HTTP/1.1
Host: example.com
Content-Type: application/json
Content-Length: 29[REQUEST BODY]:
{"key1":"value1", "key2":"value2"}
响应内容
Response: {"status":"success","message":"Data received"}
总结
通过启用 CURLOPT_VERBOSE 或自定义 CURLOPT_DEBUGFUNCTION，可以轻松查看 libcurl 的请求消息（包括请求头和请求体）。结合响应回调函数，能完整调试 HTTP 请求和服务器返回的内容。这些工具对于开发和调试网络程序非常有用！