如何使用CURL将请求缓冲区写入BYTE*类型变量

实现方案 #

libcurl的CURLOPT_WRITEFUNCTION回调有固定签名，你传入的&raw_data是BYTE**类型，需要在回调内做类型强转，同时搭配动态内存扩容逻辑，避免内存越界。

1. 推荐实现（上下文安全，支持多请求） #

优先通过自定义结构体传递缓冲区上下文，避免静态变量导致的线程安全、多请求冲突问题：

定义缓冲区结构体

typedef struct {
    BYTE* data;      // 数据缓冲区指针
    size_t length;   // 已写入数据长度
    size_t capacity; // 缓冲区总容量
} CurlReceiveBuffer;

初始化curl参数

CurlReceiveBuffer buf = {.data = NULL, .length = 0, .capacity = 0};
// 传入结构体指针作为WRITEDATA参数
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &buf);
// 绑定回调函数
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, curl_write_callback);

实现回调函数

size_t curl_write_callback(char *ptr, size_t size, size_t nmemb, void *userdata) {
    size_t block_size = size * nmemb;
    CurlReceiveBuffer* buf = (CurlReceiveBuffer*)userdata;

    // 计算扩容后的容量，额外留1字节可用于后续补'\0'当字符串处理，不需要可删除+1逻辑
    size_t required_cap = buf->length + block_size + 1;
    if (required_cap > buf->capacity) {
        BYTE* new_buf = realloc(buf->data, required_cap);
        if (new_buf == NULL) {
            // 内存分配失败，返回0终止curl请求
            return 0;
        }
        buf->data = new_buf;
        buf->capacity = required_cap;
    }

    // 拷贝新收到的数据到缓冲区
    memcpy(buf->data + buf->length, ptr, block_size);
    buf->length += block_size;
    // 可选：末尾补0，方便直接作为C字符串使用
    buf->data[buf->length] = '\0';

    // 必须返回实际接收的块大小，否则curl会中断请求
    return block_size;
}

2. 直接使用BYTE*的极简实现（仅单请求场景可用） #

如果不需要兼容多请求/多线程场景，也可以直接传递BYTE**作为参数：

size_t curl_write_callback(char *ptr, size_t size, size_t nmemb, void *userdata) {
    static size_t total_received = 0;
    size_t block_size = size * nmemb;
    BYTE** raw_data = (BYTE**)userdata;

    *raw_data = realloc(*raw_data, total_received + block_size + 1);
    if (*raw_data == NULL) {
        return 0;
    }

    memcpy(*raw_data + total_received, ptr, block_size);
    total_received += block_size;
    (*raw_data)[total_received] = '\0';

    return block_size;
}

注意：两种实现方式申请的缓冲区都需要在使用完毕后手动调用free释放，避免内存泄漏。

常见问题排查 #

• 回调返回值必须等于size * nmemb，如果返回值小于该值，libcurl会判定为写入失败，终止后续数据接收
• 禁止直接对初始为NULL的raw_data执行memcpy操作，必须先分配足够内存空间
• 多线程/多请求场景下禁止用静态变量存储接收长度，会出现数据串扰问题

内容的提问来源于stack exchange，提问作者Elberer