使用libcurl执行IMAP FETCH命令返回不完整响应的问题排查

问题描述 #

使用C语言libcurl库连接Outlook或Gmail的IMAP服务器，完成登录并选中收件箱后，执行IMAP FETCH命令获取指定邮件内容时，返回的响应始终不完整：

• 获取邮件Subject时，仅得到 * 5 FETCH (BODY[HEADER.FIELDS (SUBJECT) {27}，缺少实际主题内容
• 获取完整BODY[]时，仅得到 * 5 FETCH (BODY[] {44037}，后续邮件内容未返回

用户猜测大括号内的数字是需读取的字节数，但不知道如何处理，希望解决该问题以获取完整邮件内容并解析附件。测试代码如下：

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>


int main(void) {
    CURL *curl;
    CURLcode res;

    curl = curl_easy_init();

    if (curl) {
        //curl_easy_setopt(curl, CURLOPT_URL, "imaps://imap.gmail.com");
        curl_easy_setopt(curl, CURLOPT_URL, "imaps://outlook.office365.com");
        curl_easy_setopt(curl, CURLOPT_USE_SSL, CURLUSESSL_ALL);
        curl_easy_setopt(curl, CURLOPT_PORT, 993);
        curl_easy_setopt(curl, CURLOPT_USERNAME, "your_email_address");
        curl_easy_setopt(curl, CURLOPT_PASSWORD, "your_password");

        res = curl_easy_perform(curl);

        if (res != CURLE_OK) {
            fprintf(stderr, "Login failed: %s\n", curl_easy_strerror(res));
            curl_easy_cleanup(curl);
            return 1;
        }

        //const char *select_command = "SELECT \"[Gmail]/All Mail\"";
        const char *select_command = "SELECT Inbox";
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, select_command);
        res = curl_easy_perform(curl);

        if (res != CURLE_OK) {
            fprintf(stderr, "Selecting mailbox failed: %s (%d)\n", curl_easy_strerror(res), res);
        } else {
            printf("Mailbox selected successfully!\n");

            // Modify fetch_command to fetch the entire body of the email
            const char *fetch_command = "FETCH 5 (BODY[])";
            curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, fetch_command);

            // Create a file to save the fetched data
            FILE *file = fopen("fetched_data.txt", "wb");
            if (!file) {
                fprintf(stderr, "Failed to create file to save fetched data\n");
            } else {
                curl_easy_setopt(curl, CURLOPT_WRITEDATA, file);
               // curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data);

                res = curl_easy_perform(curl);

                if (res != CURLE_OK) {
                    fprintf(stderr, "Fetching data failed: %s (%d)\n", curl_easy_strerror(res), res);
                } else {
                    printf("Data fetched and saved successfully!\n");
                }

                fclose(file);
            }
        }

        curl_easy_cleanup(curl);
    }

    return 0;
}

原因分析 #

IMAP协议中，FETCH命令的响应采用分块传输格式：大括号内的数字是后续要发送的邮件内容字节长度，这是IMAP标准的响应格式。你的代码中仅发送了FETCH命令，但未配置libcurl自动处理后续的内容接收流程，导致只捕获了响应的头部部分，未获取到实际的邮件内容。

解决方案 #

关键修改点 #

1. 添加CURLOPT_IMAP_FETCH_CONTENT选项，告诉libcurl自动处理FETCH命令的完整响应，包括后续的内容块
2. 可选：启用CURLOPT_VERBOSE查看完整IMAP交互过程，方便调试

修改后的完整代码 #

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

// 自定义写函数（可选，默认写文件函数也可工作）
size_t write_data(void *ptr, size_t size, size_t nmemb, FILE *stream) {
    return fwrite(ptr, size, nmemb, stream);
}

int main(void) {
    CURL *curl;
    CURLcode res;

    curl = curl_easy_init();

    if (curl) {
        // 配置IMAP服务器地址（二选一）
        //curl_easy_setopt(curl, CURLOPT_URL, "imaps://imap.gmail.com");
        curl_easy_setopt(curl, CURLOPT_URL, "imaps://outlook.office365.com");
        
        curl_easy_setopt(curl, CURLOPT_USE_SSL, CURLUSESSL_ALL);
        curl_easy_setopt(curl, CURLOPT_PORT, 993);
        curl_easy_setopt(curl, CURLOPT_USERNAME, "your_email_address");
        curl_easy_setopt(curl, CURLOPT_PASSWORD, "your_password");
        
        // 启用调试输出（可选，方便查看IMAP交互细节）
        //curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);

        // 登录服务器
        res = curl_easy_perform(curl);
        if (res != CURLE_OK) {
            fprintf(stderr, "Login failed: %s\n", curl_easy_strerror(res));
            curl_easy_cleanup(curl);
            return 1;
        }

        // 选中收件箱
        const char *select_command = "SELECT Inbox";
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, select_command);
        res = curl_easy_perform(curl);
        if (res != CURLE_OK) {
            fprintf(stderr, "Selecting mailbox failed: %s (%d)\n", curl_easy_strerror(res), res);
            curl_easy_cleanup(curl);
            return 1;
        }
        printf("Mailbox selected successfully!\n");

        // 配置FETCH命令及内容处理选项
        const char *fetch_command = "FETCH 5 (BODY[])";
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, fetch_command);
        // 关键：让libcurl自动处理FETCH的完整内容
        curl_easy_setopt(curl, CURLOPT_IMAP_FETCH_CONTENT, 1L);

        // 保存到文件
        FILE *file = fopen("fetched_data.txt", "wb");
        if (!file) {
            fprintf(stderr, "Failed to create file to save fetched data\n");
            curl_easy_cleanup(curl);
            return 1;
        }
        // 设置写数据目标和自定义写函数（可选）
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, file);
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data);

        // 执行FETCH命令
        res = curl_easy_perform(curl);
        if (res != CURLE_OK) {
            fprintf(stderr, "Fetching data failed: %s (%d)\n", curl_easy_strerror(res), res);
        } else {
            printf("Data fetched and saved successfully!\n");
        }

        fclose(file);
        curl_easy_cleanup(curl);
    }

    return 0;
}

代码说明 #

• CURLOPT_IMAP_FETCH_CONTENT：启用后，libcurl会自动识别IMAP FETCH响应的分块格式，接收大括号后指定长度的内容，确保获取完整的邮件数据
• 自定义write_data函数：可选，用于更灵活地处理接收到的数据（比如内存存储、实时解析），如果不需要自定义逻辑，使用默认写文件函数即可
• 调试选项CURLOPT_VERBOSE：启用后会打印所有IMAP交互细节，帮助排查连接或命令执行问题

后续解析附件建议 #

获取完整的BODY[]后，邮件内容通常是MIME格式，你需要：

1. 解析MIME边界，识别不同的邮件部分（文本、附件等）
2. 对附件部分进行Base64解码（如果是编码后的格式）
3. 根据Content-Disposition头中的文件名保存附件

可以借助MIME解析库（比如libmime）来简化这部分工作，避免手动解析复杂的MIME结构。

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