如何在 Go 中使用 IMAP 协议获取邮件正文内容

本文详解如何在 go 中通过 go-imap 库从 imap 服务器安全、高效地获取邮件正文（rfc822.text）及对应邮件头，并结合 net/mail 解析结构化信息，附可运行示例与关键注意事项。

在 Go 中使用 IMAP 协议获取邮件正文，核心在于正确构造 UID FETCH 命令并解析响应数据。不同于仅获取邮件头（如 RFC822.HEADER），获取正文需显式请求 RFC822.TEXT（纯文本正文）或更完整的 RFC822（含头+正文）。注意：RFC822.TEXT 仅返回消息体部分（不含 MIME 头），适用于纯文本邮件；若需处理 HTML 或多部分邮件（multipart），应改用 BODY[] 或 BODYSTRUCTURE 配合 BODY.PEEK[] 精确提取特定部分。

以下为完整、健壮的示例代码（基于现代 github.com/emersion/go-imap/v2 推荐库，兼容主流 IMAP 服务如 Gmail、Outlook）：

package main

import (
    "bytes"
    "fmt"
    "log"
    "mime"
    "net/mail"

    "github.com/emersion/go-imap/v2"
    "github.com/emersion/go-imap/v2/imapclient"
    "github.com/emersion/go-imap/v2/imapserver"
)

func fetchEmailBody(client *imapclient.Client, mailbox string, uid uint32) error {
    // 1. 选择邮箱（如 INBOX）
    if _, err := client.Select(mailbox, &imapclient.SelectOptions{ReadOnly: true}); err != nil {
        return fmt.Errorf("select mailbox: %w", err)
    }

    // 2. 构造 UID FETCH 命令：同时获取 HEADER 和 TEXT
    seqSet := &imap.SeqSet{}
    seqSet.AddNum(uid)

    // 使用 BODY.PEEK[] 可避免将邮件标记为已读（推荐用于只读场景）
    // RFC822.TEXT 仅返回正文；BODY[] 返回完整原始邮件（含头+正文）
    // 这里选用 BODY.PEEK[TEXT] 实现无副作用获取正文
    cmd, err := client.UIDFetch(seqSet, &imap.UIDFetchOptions{
        Items: []imap.FetchItem{
            imap.FetchRFC822Header,
            imap.FetchRFC822Text,
        },
    })
    if err != nil {
        return fmt.Errorf("failed to send UID FETCH: %w", err)
    }

    // 3. 同步接收响应
    if err := cmd.Wait(); err != nil {
        return fmt.Errorf("fetch command failed: %w", err)
    }

    // 4. 解析每条响应
    for _, msg := range cmd.Messages {
        // 获取原始 HEADER 字节
        headerBytes, ok := msg.Fields[imap.FetchRFC822Header]
        if !ok || len(headerBytes) == 0 {
            log.Printf("Warning: missing RFC822.HEADER for UID %d", uid)
            continue
        }

        // 获取原始 TEXT 字节
        textBytes, ok := msg.Fields[imap.FetchRFC822Text]
        if !ok || len(textBytes) == 0 {
            log.Printf("Warning: missing RFC822.TEXT for UID %d", uid)
            continue
        }

        // 解析邮件头（获取 Subject、From 等）
        headerReader := bytes.NewReader(headerBytes)
        mailMsg, err := mail.ReadMessage(headerReader)
        if err != nil {
            log.Printf("Failed to parse header for UID %d: %v", uid, err)
            continue
        }

        fmt.Printf("=== UID %d ===\n", uid)
        fmt.Printf("Subject: %s\n", mailMsg.Header.Get("Subject"))
        fmt.Printf("From: %s\n", mailMsg.Header.Get("From"))
        fmt.Printf("Date: %s\n", mailMsg.Header.Get("Date"))

        // 输出正文（注意：RFC822.TEXT 是纯文本，可能含换行/缩进）
        fmt.Println("\n--- Email Body (RFC822.TEXT) ---")
        fmt.Println(string(textBytes))

        // ✅ 进阶提示：处理 multipart 邮件？
        // 若需提取 HTML 或附件，请改用 BODYSTRUCTURE + BODY.PEEK[1] / BODY.PEEK[2.1] 等路径
        // 示例：BODY.PEEK[TEXT] → 纯文本；BODY.PEEK[1] → 第一部分（常为 text/plain）；BODY.PEEK[2] → 第二部分（常为 text/html）
    }

    return nil
}

⚠️ 重要注意事项：

• 认证与加密：务必使用 STARTTLS 或 IMAPS（端口 993），禁用明文密码传输；
• Gmail 特别说明：需开启「App Password」并关闭两步验证，或使用 OAuth2；
• 性能优化：批量请求多个 UID（如 seqSet.AddRange(1, 50)）比逐个请求更高效；
• 错误处理：真实项目中需检查 cmd.Status、处理 NO/BAD 响应，并添加超时控制（如 client.SetTimeout(30*time.Second)）；
• 替代方案：对复杂 MIME 解析（如嵌套 multipart/alternative），建议结合 github.com/emersion/go-message 库深度解析 BODY[] 原始数据。

掌握 UID FETCH 的字段组合与响应解析逻辑，是构建可靠邮件客户端的关键一步。始终优先使用 PEEK 类指令避免意外状态变更，并通过结构化日志确保调试可追溯。