如何使用Golang实现邮件发送功能_结合SMTP协议发送邮件

Go标准库net/smtp支持SMTP邮件发送,需配置服务商地址端口及授权码,构造RFC合规MIME邮件,按端口选STARTTLS或TLS连接,注意编码、错误处理与安全实践。

使用 Golang 发送邮件,核心是通过 SMTP 协议 与邮件服务器通信。Go 标准库 net/smtp 提供了轻量但足够实用的支持,无需第三方依赖即可完成认证、加密、发信等操作。

配置 SMTP 连接参数

发送前需明确目标 SMTP 服务的地址、端口、账号和密码(或应用专用密码)。常见服务商示例如下:

  • Gmail:smtp.gmail.com:587(STARTTLS),需开启“两步验证”并生成 App Password
  • QQ 邮箱:smtp.qq.com:587(STARTTLS)或 :465(SSL),需在邮箱设置中开启 SMTP 服务并获取授权码
  • 163 邮箱:smtp.163.com:465(SSL),同样需使用授权码而非登录密码

构造符合 RFC 标准的邮件内容

邮件正文需遵循 MIME 格式,包含 FromToSubjectDate 等头部字段,并用空行分隔头部与正文。纯文本邮件可手动拼接,推荐使用 mime/multipart 或简单字符串格式化:

msg := []byte("To: recipient@example.com\r\n" +
    "From: sender@example.com\r\n" +
    "Subject: Hello from Go\r\n" +
    "MIME-Version: 1.0\r\n" +
    "Content-Type: text/plain; charset=\"UTF-8\"\r\n" +
    "\r\n" +
    "This is a plain text email sent via Go and SMTP.")

建立安全连接并发送

根据端口类型选择连接方式::587smtp.PlainAuth + StartTLS:465 直接使用 TLS 拨号。关键步骤包括:

  • 调用 net/smtp.Dialtls.Dial 建立连接
  • 如使用 STARTTLS,需显式调用 client.StartTLS
  • 使用 client.Auth 完成身份验证(注意:密码为明文传入,确保环境安全)
  • 调用 client.SendMail 提交收件人列表与原始邮件字节

处理常见错误与注意事项

实际部署时容易遇到权限、网络或格式问题:

  • 认证失败多因密码错误或未启用 SMTP 服务,检查邮箱后台设置
  • 连接超时或拒绝,确认防火墙/代理未拦截 SMTP 端口
  • 中文主题或收件人显示异常,需对 SubjectTo 字段做 base64 编码并标注 charset
  • 生产环境建议封装重试逻辑、添加日志,并避免硬编码密码(改用环境变量或配置中心)