首页 > Golang > Go教程

Golangnet/smtp发邮件教程详解

时间：2025-07-04 09:16:34 381浏览收藏

推广推荐

支持 PC / 移动端，安全直达

从现在开始，我们要努力学习啦！今天我给大家带来《Golang使用net/smtp发送邮件教程》，感兴趣的朋友请继续看下去吧！下文中的内容我们主要会涉及到等等知识点，如果在阅读本文过程中有遇到不清楚的地方，欢迎留言呀！我们一起讨论，一起学习！

在Golang中使用net/smtp包发送邮件失败的常见原因包括：1.SMTP服务器配置错误，需检查地址和端口；2.认证失败，需确保账号密码或授权码正确；3.网络问题，需确认SMTP端口开放；4.邮件内容格式错误，需规范头部和空行分隔；5.被SMTP服务器拒绝，可能因IP黑名单或内容被判垃圾邮件。解决这些问题后，可正常发送邮件。

如何用Golang实现一个简单的邮件发送程序讲解net/smtp使用

Golang中实现邮件发送，核心在于net/smtp包的使用。它简化了与SMTP服务器交互的复杂性，让你能用几行代码就能搞定邮件发送。

解决方案

首先，你需要准备一个SMTP服务器的地址、端口，以及一个用于发送邮件的邮箱账号和密码。接下来，就可以开始编写Golang代码了。

package main

import (
    "net/smtp"
    "log"
)

func main() {
    // 邮件发送配置
    from := "your_email@example.com" // 发件人邮箱
    password := "your_password"        // 发件人邮箱密码
    to := []string{"recipient@example.com"} // 收件人邮箱

    // SMTP服务器配置
    smtpServer := "smtp.example.com"  // SMTP服务器地址
    smtpPort := "587"                // SMTP服务器端口

    // 邮件内容
    message := []byte("Subject: Golang Email Test\r\n" +
        "To: recipient@example.com\r\n" +
        "From: your_email@example.com\r\n" +
        "\r\n" +
        "This is a test email sent from Golang using net/smtp package.")

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

    // 发送邮件
    err := smtp.SendMail(smtpServer+":"+smtpPort, auth, from, to, message)
    if err != nil {
        log.Fatal(err)
        return // 这里添加 return 语句，防止程序继续执行
    }

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

这段代码的关键在于smtp.SendMail函数。它接收SMTP服务器地址、认证信息、发件人、收件人以及邮件内容作为参数，并尝试发送邮件。如果发送过程中出现任何错误，程序将打印错误信息并退出。

为什么我的邮件总是发送失败？

常见的原因包括：

SMTP服务器配置错误： 检查SMTP服务器地址和端口是否正确。不同邮件服务提供商的配置可能不同。
认证失败： 确保你提供的邮箱账号和密码是正确的。有些邮箱可能需要开启“允许不安全应用访问”才能使用SMTP发送邮件。此外，部分邮箱启用了独立密码（客户端授权码），需要使用授权码代替邮箱密码。
网络问题： 检查你的网络连接是否正常。如果你的服务器位于防火墙后面，需要确保SMTP端口是开放的。
邮件内容格式错误： 邮件头部信息（如Subject、To、From）的格式必须正确，并且需要用\r\n分隔。此外，邮件内容必须以空行（\r\n\r\n）与头部信息分隔。
被SMTP服务器拒绝： 某些SMTP服务器可能会因为各种原因拒绝你的邮件，例如，你的IP地址被列入黑名单，或者你的邮件内容被认为是垃圾邮件。查看SMTP服务器的日志可以获取更多信息。

如何发送带有HTML内容的邮件？

要发送带有HTML内容的邮件，你需要设置邮件的Content-Type头部为text/html。

message := []byte("Subject: Golang HTML Email Test\r\n" +
    "To: recipient@example.com\r\n" +
    "From: your_email@example.com\r\n" +
    "Content-Type: text/html; charset=UTF-8\r\n" + // 添加 Content-Type 头部
    "\r\n" +
    "<html><body><h1>Hello, World!</h1><p>This is an HTML email sent from Golang.</p></body></html>")

注意，Content-Type头部必须放在邮件头部信息的最后，并且在头部信息和邮件内容之间需要有一个空行。

如何发送带附件的邮件？

发送带附件的邮件稍微复杂一些，你需要使用mime/multipart包来构造邮件内容。以下是一个简单的示例：

package main

import (
    "bytes"
    "log"
    "mime/multipart"
    "net/smtp"
    "net/textproto"
    "os"
    "path/filepath"
)

func main() {
    from := "your_email@example.com"
    password := "your_password"
    to := []string{"recipient@example.com"}
    smtpServer := "smtp.example.com"
    smtpPort := "587"
    filePath := "attachment.txt" // 附件路径

    var body bytes.Buffer
    writer := multipart.NewWriter(&body)

    // 邮件头部
    header := make(textproto.MIMEHeader)
    header.Set("Subject", "Golang Email with Attachment")
    header.Set("To", "recipient@example.com")
    header.Set("From", "your_email@example.com")
    header.Set("Content-Type", writer.FormDataContentType())

    // 添加邮件正文
    part, err := writer.CreatePart(textproto.MIMEHeader{
        "Content-Type": {"text/plain; charset=UTF-8"},
    })
    if err != nil {
        log.Fatal(err)
    }
    part.Write([]byte("This is the email body with an attachment.\r\n"))

    // 添加附件
    file, err := os.Open(filePath)
    if err != nil {
        log.Fatal(err)
    }
    defer file.Close()

    part, err = writer.CreatePart(textproto.MIMEHeader{
        "Content-Disposition": {`attachment; filename="` + filepath.Base(filePath) + `"`},
        "Content-Type":        {"application/octet-stream"},
    })
    if err != nil {
        log.Fatal(err)
    }
    buf := new(bytes.Buffer)
    buf.ReadFrom(file)
    part.Write(buf.Bytes())

    err = writer.Close()
    if err != nil {
        log.Fatal(err)
    }

    auth := smtp.PlainAuth("", from, password, smtpServer)
    err = smtp.SendMail(smtpServer+":"+smtpPort, auth, from, to, body.Bytes())
    if err != nil {
        log.Fatal(err)
    }

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

这个示例首先创建一个multipart.Writer来构造邮件内容。然后，它分别添加邮件正文和附件作为不同的part。注意，附件的Content-Disposition头部指定了附件的文件名。

如何处理大量的邮件发送任务？

如果需要发送大量的邮件，建议使用goroutine和channel来并发处理。这样可以显著提高发送速度。同时，需要注意控制并发数量，避免对SMTP服务器造成过大的压力。此外，还可以考虑使用专业的邮件发送服务，它们通常提供更高的发送速度和更好的送达率。

终于介绍完啦！小伙伴们，这篇关于《Golangnet/smtp发邮件教程详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！

golang 邮件发送 SMTP服务器 net/smtp 邮件内容