使用C/C++调用libcurl调试消息的方式

更新时间：2025年02月06日 09:32:37 作者：云梦谭

在使用 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 请求和服务器返回的内容。这些工具对于开发和调试网络程序非常有用！

到此这篇关于使用C/C++调用libcurl调试消息的方式的文章就介绍到这了,更多相关C/C++调用libcurl调试消息内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

C++函数重载的深入解析
在C++中，我们也能够把具有相同功能的函数整合到一个函数上，而不必去写好多个函数名不同的函数，这叫做函数的重载。以下是对C++中的函数重载进行了详细的分析介绍，需要的朋友可以过来参考下
2013-07-07
Sublime Text 3 实现C语言代码的编译和运行(示例讲解)
下面小编就为大家带来一篇Sublime Text 3 实现C语言代码的编译和运行(示例讲解)。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-09-09
C++容器算法示例详解
在谈到容器算法,我们大概率会用到谓词predicate,谓词返回的类型是布尔类型(bool)可以是lambda表达式、函数对象以及其它可调用的对象,这篇文章主要介绍了C++容器算法,需要的朋友可以参考下
2024-08-08
C语言中的断言函数assert详解
assert 是一个非常有用的工具,可以帮助开发人员在早期发现和纠正程序中的逻辑错误,在调试阶段通过断言可以验证程序中的假设条件是否成立,提高代码的可靠性和可维护性,这篇文章主要介绍了C语言中的断言函数assert,需要的朋友可以参考下
2024-07-07
C语言学生成绩管理系统小设计
这篇文章主要为大家详细介绍了C语言学生成绩管理系统小设计，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2018-01-01
Windows下Qt打包自动寻找依赖的DLL
本文介绍了两种在Windows下使用Qt打包应用程序并自动寻找依赖DLL的方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2024-12-12
浅谈分词器Tokenizer
分词器的工作就是分解文本流成词(tokens).在这个文本中,每一个token都是这些字符的一个子序列。一个分析器(analyzer)必须知道它所配置的字段,但是tokenizer不需要,分词器(tokenizer)从一个字符流(reader)读取数据,生成一个Token对象(TokenStream)的序列
2021-06-06
C++实现二分法求方程近似解
这篇文章主要为大家详细介绍了C++实现二分法求方程近似解，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-05-05
QT使用QComBox和QLineEdit实现模糊查询功能
模糊查询是指根据用户输入的文本,在下拉框的选项中进行模糊匹配,并动态地显示匹配的选项,本文将使用QComBox和QLineEdit实现模糊查询功能,需要的可以参考下
2023-11-11
使用C++创建多个IPC机制的上层接口
设计一个上层的IPC接口,这个接口将在未来封装底层的通信机制,这样的设计要求接口足够抽象,以便于底层实现的细节对上层用户透明,本文给大家介绍了如何使用C++创建多个IPC机制的上层接口,文中通过代码示例介绍的非常详细,需要的朋友可以参考下
2023-12-12