libcurl分块编码格式错误：调用Web REST API失败求助

这个错误我之前排查过几次，本质是libcurl在解析服务器返回的分块编码响应时，发现格式不符合HTTP规范。结合你给出的代码片段，咱们从几个方向来定位和解决：

一、先确认问题根源：服务器还是客户端？ #

分块编码的响应必须严格遵循[十六进制块长度]\r\n[块内容]\r\n的格式，最后以0\r\n\r\n收尾。如果服务器返回的块长度不是合法十六进制、缺少必要的换行符，或者块内容长度和声明的长度不匹配，都会触发这个错误。

你可以先通过命令行curl工具验证：

curl -v <你的API请求地址>

查看输出里的< HTTP/1.1 200 OK之后的响应内容，重点看分块的格式是否合规。如果确实是服务器的问题，优先联系后端修复；如果需要客户端兼容这种不规范的响应，可以尝试禁用libcurl的自动分块解码：

// 禁用HTTP传输解码，包括分块编码
curl_easy_setopt(curl, CURLOPT_HTTP_TRANSFER_DECODING, 0);

不过禁用后你需要自己处理响应数据，比如手动解析分块，或者要求服务器返回带Content-Length的非分块响应。

二、检查你的响应处理函数的内存操作问题 #

从你给出的write_resp_data片段来看，这里有几个容易踩坑的地方：

1. realloc失败后的错误处理不当：libcurl要求写入函数返回实际处理的字节数，返回-1会直接中止传输，可能掩盖真实的分块错误。应该保留原指针，返回0表示未处理数据；
2. 未确保字符串终止：拼接数据后要加上\0，避免后续处理时出现内存越界。

修正后的函数应该是这样：

struct wapi_resp_data { char *ptr; size_t len; };

static size_t write_resp_data(void *data, size_t size, size_t nmemb, void *param) {
    struct wapi_resp_data *res = (struct wapi_resp_data *) param;
    size_t total_bytes = size * nmemb;
    size_t new_len = res->len + total_bytes;

    // 先分配新内存，避免realloc失败丢失原数据
    char *new_ptr = realloc(res->ptr, new_len + 1);
    if (!new_ptr) {
        // 内存分配失败，返回0表示未处理任何数据
        return 0;
    }

    res->ptr = new_ptr;
    memcpy(&res->ptr[res->len], data, total_bytes);
    res->len = new_len;
    res->ptr[res->len] = '\0'; // 确保字符串以NULL结尾

    return total_bytes;
}

另外，初始化wapi_resp_data时一定要把ptr设为NULL，len设为0：

struct wapi_resp_data resp = {.ptr = NULL, .len = 0};

三、启用详细调试日志定位具体错误 #

如果上面的方法还没解决，可以开启libcurl的调试日志，直接查看服务器返回的原始数据，精准定位分块编码的错误位置：

// 调试回调函数，打印收到的响应数据
static int debug_logger(CURL *curl, curl_infotype type, char *data, size_t size, void *userdata) {
    if (type == CURLINFO_DATA_IN) {
        fprintf(stderr, "Received raw response data:\n%.*s\n", (int)size, data);
    }
    return 0;
}

// 在初始化curl时启用调试
curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);
curl_easy_setopt(curl, CURLOPT_DEBUGFUNCTION, debug_logger);

通过日志你可以直接看到服务器返回的分块内容，检查哪一部分不符合规范。

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