如何使用 AWS SES Go SDK 发送带附件的邮件-Golang-PHP中文网

如何使用 AWS SES Go SDK 发送带附件的邮件

aws ses 的 sendemail api 不支持直接添加附件，必须改用 sendrawemail api 构造符合 mime 标准的原始邮件（raw message），才能嵌入 pdf 等二进制附件。

aws ses 的 sendemail api 不支持直接添加附件，必须改用 sendrawemail api 构造符合 mime 标准的原始邮件（raw message），才能嵌入 pdf 等二进制附件。

要通过 AWS SES 使用 Go SDK 发送带附件（如 PDF）的邮件，关键在于放弃 SendEmail，转而使用 SendRawEmail —— 因为后者允许你完全控制邮件的 MIME 结构，从而支持多部分（multipart/mixed）、Base64 编码附件、内联资源及自定义头信息。

✅ 正确做法：构造标准 MIME 原始邮件

SendRawEmailInput.RawMessage.Data 字段需传入一个完整的、符合 RFC 5322 和 MIME 规范的原始邮件字节流。它通常包含：

From, To, Subject, Date 等标准头字段；
MIME-Version: 1.0；
Content-Type: multipart/mixed; boundary="..."；
多个 MIME 部分：纯文本/HTML 正文 + 经 Base64 编码的附件（如 PDF）。

以下是一个完整、可运行的 Go 示例（使用 golang.org/x/net/html 非必需，但 mime/multipart 是核心）：

package main

import (
    "bytes"
    "encoding/base64"
    "fmt"
    "io"
    "mime/multipart"
    "strings"

    "github.com/aws/aws-sdk-go/aws"
    "github.com/aws/aws-sdk-go/aws/session"
    "github.com/aws/aws-sdk-go/service/ses"
)

func sendEmailWithAttachment(
    sesSvc *ses.SES,
    from, to, subject string,
    htmlBody string,
    pdfData []byte, // 例如：os.ReadFile("report.pdf")
    filename string, // 如 "report.pdf"
) error {
    // 1. 创建内存缓冲区和 multipart writer
    var buf bytes.Buffer
    writer := multipart.NewWriter(&buf)

    // 2. 设置随机 boundary（writer 自动处理）
    boundary := writer.Boundary()

    // 3. 添加 HTML 正文部分
    part, _ := writer.CreatePart(map[string][]string{
        "Content-Type": {"text/html; charset=utf-8"},
    })
    io.WriteString(part, htmlBody)

    // 4. 添加附件部分
    attachmentPart, _ := writer.CreatePart(map[string][]string{
        "Content-Type":  {fmt.Sprintf("application/pdf; name=\"%s\"", filename)},
        "Content-Disposition": {fmt.Sprintf("attachment; filename=\"%s\"", filename)},
        "Content-Transfer-Encoding": {"base64"},
    })
    encoder := base64.NewEncoder(base64.StdEncoding, attachmentPart)
    encoder.Write(pdfData)
    encoder.Close()

    // 5. 关闭 multipart writer（写入 final boundary）
    writer.Close()

    // 6. 构建原始邮件数据：含必要邮件头
    rawEmail := fmt.Sprintf(
        "From: %s\r\n"+
            "To: %s\r\n"+
            "Subject: %s\r\n"+
            "MIME-Version: 1.0\r\n"+
            "Content-Type: multipart/mixed; boundary=\"%s\"\r\n\r\n",
        from, to, subject, boundary,
    ) + buf.String()

    // 7. 调用 SendRawEmail
    input := &ses.SendRawEmailInput{
        RawMessage: &ses.RawMessage{
            Data: []byte(rawEmail),
        },
        Source: aws.String(from),
        Destinations: []*string{
            aws.String(to),
        },
    }

    _, err := sesSvc.SendRawEmail(input)
    return err
}

// 使用示例
func main() {
    sess := session.Must(session.NewSessionWithOptions(session.Options{
        SharedConfigState: session.SharedConfigState{
            Config: aws.Config{Region: aws.String("us-east-1")},
        },
    }))
    svc := ses.New(sess)

    err := sendEmailWithAttachment(
        svc,
        "sender@example.com",
        "recipient@example.com",
        "Monthly Report with PDF",
        "<h1>Hello!</h1><p>Please find the attached report.</p>",
        []byte("%PDF-1.4..."), // 替换为真实 PDF 字节
        "monthly-report.pdf",
    )
    if err != nil {
        panic(err)
    }
    fmt.Println("Email sent successfully with attachment.")
}

⚠️ 注意事项与最佳实践

编码严格性：每行结尾必须是 \r\n（CRLF），不可用 \n；空行分隔邮件头与正文。
附件命名安全：确保 filename 经过清理（避免路径遍历或特殊字符），建议使用 path.Base() + 白名单校验。
大小限制：SES 单封原始邮件总大小上限为 40 MB（含所有附件和正文），注意 Base64 编码会使附件体积膨胀约 33%。
身份验证与权限：确保你的 IAM 用户/角色拥有 ses:SendRawEmail 权限，且发信邮箱或域名已在 SES 中完成验证（生产环境需申请发送配额）。
调试技巧：先将 rawEmail 字符串打印出来，用在线 MIME 解析器（如 https://www.php.cn/link/e7b51e38cc1234fff284d2dbaa301e3b）验证结构是否合法。
替代方案：若频繁处理复杂邮件，推荐封装复用的 MIMEBuilder 工具类，或采用成熟库如 gomail（需自行集成 SES 传输层）。