首页 > Golang > Go教程

GolangSMTP邮件配置教程详解

时间：2025-12-01 16:17:52 351浏览收藏

想知道如何用 Golang 发送邮件吗？本文为你提供一份详细的 Golang SMTP 发送邮件配置教程，基于 `net/smtp` 包，教你轻松实现邮件发送功能。从配置 SMTP 服务器信息、解决认证问题（如 `smtp.PlainAuth` 的使用），到发送 HTML 格式邮件，再到利用 `mime/multipart` 包发送带附件的邮件，本文都将一一讲解。同时，还包括错误处理技巧，例如如何判断和处理连接超时、认证失败等常见异常。掌握这些技巧，让你的 Golang 应用也能具备强大的邮件发送能力！

答案：使用net/smtp包配置SMTP服务器信息并构造邮件内容，通过smtp.PlainAuth实现认证，设置邮件头的Content-Type为text/html发送HTML邮件，利用mime/multipart包构建正文和附件的多部分消息以发送带附件邮件，同时通过错误类型判断处理连接超时、认证失败等异常。

Golang发送电子邮件 smtp包配置与发送

Golang发送邮件，核心在于net/smtp包的使用。配置好SMTP服务器信息，就能轻松发送邮件了。

解决方案

首先，需要配置SMTP服务器的连接信息，包括服务器地址、端口、用户名和密码。然后，构造邮件内容，包括发件人、收件人、主题和正文。最后，使用smtp.SendMail函数发送邮件。

如何处理SMTP服务器的认证问题？

SMTP服务器认证是发送邮件的关键一步。很多服务器都需要验证你的身份，防止垃圾邮件。smtp.SendMail函数需要一个smtp.Auth接口的实现。smtp包提供了几种认证方式，最常用的是smtp.PlainAuth。

例如：

package main

import (
    "fmt"
    "net/smtp"
    "log"
)

func main() {
    // SMTP服务器配置
    smtpServer := "smtp.example.com"
    smtpPort := 587
    smtpUser := "your_email@example.com"
    smtpPass := "your_password"
    from := "your_email@example.com"
    to := []string{"recipient@example.com"}
    subject := "Golang SMTP Email"
    body := "This is a test email from Golang using the smtp package."

    // 构造邮件内容
    message := []byte("To: recipient@example.com\r\n" +
        "Subject: " + subject + "\r\n" +
        "\r\n" + body + "\r\n")

    // 认证信息
    auth := smtp.PlainAuth("", smtpUser, smtpPass, smtpServer)

    // 连接SMTP服务器并发送邮件
    err := smtp.SendMail(fmt.Sprintf("%s:%d", smtpServer, smtpPort), auth, from, to, message)
    if err != nil {
        log.Fatal(err)
    }

    fmt.Println("Email sent successfully!")
}

这段代码展示了如何使用smtp.PlainAuth进行认证。需要注意的是，实际应用中，用户名和密码应该从安全的地方读取，例如环境变量或配置文件，而不是硬编码在代码中。

如果你的SMTP服务器使用其他认证方式，例如CRAM-MD5或LOGIN，你需要使用相应的smtp.Auth接口实现。

如何发送HTML格式的邮件？

发送HTML邮件需要在邮件头中指定Content-Type。

修改上面的例子：

package main

import (
    "fmt"
    "net/smtp"
    "log"
)

func main() {
    // SMTP服务器配置
    smtpServer := "smtp.example.com"
    smtpPort := 587
    smtpUser := "your_email@example.com"
    smtpPass := "your_password"
    from := "your_email@example.com"
    to := []string{"recipient@example.com"}
    subject := "Golang SMTP HTML Email"
    body := `<!DOCTYPE html>
<html>
<head>
<title>HTML Email</title>
</head>
<body>
<h1>This is an HTML email from Golang!</h1>
<p>Using the <strong>smtp</strong> package.</p>
</body>
</html>`

    // 构造邮件内容
    message := []byte("To: recipient@example.com\r\n" +
        "Subject: " + subject + "\r\n" +
        "MIME-version: 1.0\r\n" +
        "Content-Type: text/html; charset=\"UTF-8\"\r\n" +
        "\r\n" + body + "\r\n")

    // 认证信息
    auth := smtp.PlainAuth("", smtpUser, smtpPass, smtpServer)

    // 连接SMTP服务器并发送邮件
    err := smtp.SendMail(fmt.Sprintf("%s:%d", smtpServer, smtpPort), auth, from, to, message)
    if err != nil {
        log.Fatal(err)
    }

    fmt.Println("Email sent successfully!")
}

注意Content-Type: text/html; charset="UTF-8"这行，它告诉邮件客户端这是一个HTML邮件，并且使用UTF-8编码。

如何发送带有附件的邮件？

发送带附件的邮件稍微复杂一些，需要使用mime/multipart包来构造邮件内容。简单来说，你需要将邮件正文和附件分别作为multipart.Part添加到multipart.Writer中，并设置正确的Content-Type和Content-Disposition。

这部分代码比较长，这里只给出思路：

创建multipart.Writer。
添加邮件正文部分，设置Content-Type: text/plain; charset="UTF-8"或Content-Type: text/html; charset="UTF-8"。
添加附件部分，设置Content-Type为附件的MIME类型，例如application/pdf，设置Content-Disposition: attachment; filename="your_file.pdf"。
将multipart.Writer的内容写入到bytes.Buffer中。
设置邮件头的Content-Type为multipart/mixed; boundary="your_boundary"，其中your_boundary是multipart.Writer的边界字符串。
使用smtp.SendMail发送邮件。

实际操作中，可以使用现成的库，例如github.com/jordan-wright/email，它简化了发送带附件邮件的过程。

如何处理发送邮件时遇到的错误？

发送邮件时可能会遇到各种错误，例如连接超时、认证失败、服务器拒绝等。需要仔细处理这些错误，并提供有用的错误信息。

例如，可以检查smtp.SendMail返回的错误类型：

err := smtp.SendMail(fmt.Sprintf("%s:%d", smtpServer, smtpPort), auth, from, to, message)
if err != nil {
    if netErr, ok := err.(net.Error); ok && netErr.Timeout() {
        log.Println("Timeout error:", err)
    } else {
        log.Println("SendMail error:", err)
    }
    // 可以根据错误类型进行不同的处理
}

此外，还可以使用log包记录错误信息，方便排查问题。在生产环境中，应该对发送邮件的操作进行监控，及时发现并解决问题。

以上就是《GolangSMTP邮件配置教程详解》的详细内容，更多关于邮件发送,net/smtp,GolangSMTP,smtp.PlainAuth,附件邮件的资料请关注golang学习网公众号！

邮件发送 net/smtp GolangSMTP smtp.PlainAuth 附件邮件