如何通过 Go 程序向 MailHog 发送测试邮件

本文介绍如何在 go 中使用 smtp 客户端（如 gomail）将邮件发送至本地运行的 mailhog 实例，实现自动化邮件捕获与测试，无需真实邮件服务器。

在开发和测试阶段，验证邮件发送逻辑是个常见需求。但直接调用真实的邮件服务器？不仅慢，还可能触发垃圾邮件策略，甚至打扰到真实用户。有没有一种方法，能让我们在本地安全、高效地测试邮件内容、收件人和格式呢？答案就是 MailHog。

简单来说，MailHog 是一款专为开发者设计的轻量级邮件捕获工具。它本质上模拟了一个 SMTP 服务器，但有个关键区别：它不真的把邮件发出去，而是“截胡”下来，存到自己的肚子里。然后，通过一个清晰的 Web 界面或者 REST API，你可以随时查看被捕获的邮件，检查发件人、主题、正文乃至附件，一切尽在掌握。

这里有个重要特性需要划重点：MailHog 默认不进行任何认证或加密。它的 SMTP 服务通常监听 1025 端口（而不是标准的 25 或 587），并且对用户名和密码完全“视而不见”。这意味着，你的 Go 程序只需要像连接普通服务器一样，指向 localhost:1025，就能直接投递邮件，省去了配置认证的麻烦。

实战：使用 Gomail 库发送邮件

在 Go 生态中，gomail 是一个成熟且简洁的 SMTP 客户端库。需要注意的是，这里推荐使用其 v2 版本（即 gopkg.in/gomail.v2），而非已过时的 v1。下面是一个完整、可立即运行的示例代码：

package main

import (
    "log"
    "gopkg.in/gomail.v2"
)

func main() {
    // 创建新邮件消息
    m := gomail.NewMessage()
    m.SetHeader("From", "test@example.com")
    m.SetHeader("To", "recipient@example.com")
    m.SetHeader("Subject", "Test Email via MailHog")
    m.SetBody("text/plain", "Hello from Go! This email was sent programmatically to MailHog.")

    // 配置 PlainDialer：指向 MailHog 的 SMTP 地址（默认 localhost:1025）
    // 注意：MailHog 不需要用户名/密码，传空字符串即可；若填入任意值也不会被校验
    dialer := gomail.NewPlainDialer("localhost", 1025, "", "")

    // 发送邮件
    if err := dialer.DialAndSend(m); err != nil {
        log.Fatalf("Failed to send email to MailHog: %v", err)
    }
    log.Println("✅ Email successfully sent to MailHog!")
}

关键注意事项与最佳实践

代码写好了，但在运行前，有几个细节必须确认，它们直接决定了测试能否成功：

• ✅ 确保 MailHog 已启动：这是前提。你可以通过执行 mailhog 命令来启动，如果使用 Docker，运行 docker run -d -p 1025:1025 -p 8025:8025 mailhog/mailhog 即可。8025端口是Web UI的访问入口。
• ✅ 地址与端口要匹配：SMTP 地址必须是 localhost（或者你的 MailHog 容器在网络内可达的地址），端口固定为 1025，除非你启动时自定义了参数。
• ❌ 不要填写真实凭证：用户名和密码字段留空字符串 "" 就行。MailHog 会忽略它们，但如果你错误地填入了真实邮箱的账号密码，某些客户端库的行为反而可能导致连接问题。
• ✅ 扩展邮件类型：除了纯文本，发送 HTML 邮件也很简单，只需追加一行代码：m.AddAlternative("text/html", "

  Hello

  ")。
• ✅ 实现测试闭环：这才是高级玩法。你可以在发送邮件后，结合 Go 的 http.Client 去调用 MailHog 提供的 /api/v2/messages REST 接口，获取最新捕获的邮件并进行自动化断言（比如检查主题、收件人是否正确），从而将邮件测试完整地集成到你的单元测试或 CI 流程中。

总结来说，将 Go 程序与 MailHog 结合，相当于为你的应用搭建了一个私密的、无副作用的邮件“沙箱”。它彻底隔离了对外部邮件服务的依赖，让邮件逻辑的验证变得快速、可重复且绝对安全。对于追求可靠性的现代 Go 应用集成测试而言，这无疑是一种最佳实践。