Go語言輕松實(shí)現(xiàn)郵件發(fā)送通知功能的完全指南

更新時(shí)間：2025年04月03日 09:53:29 作者：程序員愛釣魚

在現(xiàn)代 Web 應(yīng)用中,郵件通知是一個(gè)不可或缺的功能,本文將深入解析一個(gè)基于 Go 語言 smtp 協(xié)議和 email 庫的郵件發(fā)送工具,需要的可以了解下

在現(xiàn)代 Web 應(yīng)用中，郵件通知是一個(gè)不可或缺的功能，無論是用戶注冊(cè)、密碼重置，還是系統(tǒng)報(bào)警，郵件都能提供及時(shí)的信息傳遞。在這篇文章中，我們將深入解析一個(gè)基于 Go 語言 smtp 協(xié)議和 email 庫的郵件發(fā)送工具，并提供詳細(xì)的代碼示例，助你快速集成郵件功能！

Go 語言如何發(fā)送郵件

在 Go 語言中，可以使用 net/smtp 標(biāo)準(zhǔn)庫發(fā)送郵件，但它的 API 設(shè)計(jì)較為底層，使用起來相對(duì)麻煩。因此，我們借助 jordan-wright/email 庫來簡化郵件發(fā)送邏輯，使其更易讀、更易用。

本文基于 gin-vue-admin 框架的插件封裝了郵件發(fā)送工具，支持普通郵件發(fā)送、錯(cuò)誤告警郵件、郵件測(cè)試等功能。

代碼實(shí)現(xiàn)解析

首先，我們來看核心代碼：

package utils

import (
    "crypto/tls"
    "fmt"
    "net/smtp"
    "strings"

    "github.com/flipped-aurora/gin-vue-admin/server/plugin/email/global"
    "github.com/jordan-wright/email"
)

// 發(fā)送郵件的主方法
func send(to []string, subject string, body string) error {
    from := global.GlobalConfig.From
    nickname := global.GlobalConfig.Nickname
    secret := global.GlobalConfig.Secret
    host := global.GlobalConfig.Host
    port := global.GlobalConfig.Port
    isSSL := global.GlobalConfig.IsSSL

    auth := smtp.PlainAuth("", from, secret, host)
    e := email.NewEmail()
    if nickname != "" {
        e.From = fmt.Sprintf("%s <%s>", nickname, from)
    } else {
        e.From = from
    }
    e.To = to
    e.Subject = subject
    e.HTML = []byte(body)

    var err error
    hostAddr := fmt.Sprintf("%s:%d", host, port)
    if isSSL {
        err = e.SendWithTLS(hostAddr, auth, &tls.Config{ServerName: host})
    } else {
        err = e.Send(hostAddr, auth)
    }
    return err
}

// 普通郵件發(fā)送方法
func Email(To, subject, body string) error {
    to := strings.Split(To, ",")
    return send(to, subject, body)
}

// 發(fā)送錯(cuò)誤告警郵件
func ErrorToEmail(subject, body string) error {
    to := strings.Split(global.GlobalConfig.To, ",")
    if to[len(to)-1] == "" {
        to = to[:len(to)-1]
    }
    return send(to, subject, body)
}

// 測(cè)試郵件發(fā)送方法
func EmailTest(subject, body string) error {
    to := []string{global.GlobalConfig.To}
    return send(to, subject, body)
}

如何使用

要使用此工具發(fā)送郵件，你需要先配置 SMTP 郵件服務(wù)器信息，例如 Gmail、QQ 郵箱、企業(yè)郵箱等。

1、配置郵件服務(wù)信息

在 global.GlobalConfig 中，添加 SMTP 服務(wù)器的配置信息，例如：

GlobalConfig = struct {
    From     string
    Nickname string
    Secret   string
    Host     string
    Port     int
    IsSSL    bool
    To       string
}{
    From:     "your_email@example.com",
    Nickname: "Go Mailer",
    Secret:   "your_smtp_secret", // QQ/163/Gmail 需要使用授權(quán)碼
    Host:     "smtp.example.com",
    Port:     465,
    IsSSL:    true,
    To:       "receiver@example.com",
}

2、發(fā)送郵件示例

以下是調(diào)用郵件工具發(fā)送郵件的示例：

發(fā)送普通郵件

err := utils.Email("receiver@example.com", "Go 郵件測(cè)試", "<h1>Hello from Go!</h1>")
if err != nil {
    fmt.Println("郵件發(fā)送失敗:", err)
} else {
    fmt.Println("郵件發(fā)送成功！")
}

發(fā)送錯(cuò)誤告警郵件

err := utils.ErrorToEmail("系統(tǒng)錯(cuò)誤", "<p>檢測(cè)到異常，請(qǐng)立即處理！</p>")
if err != nil {
    fmt.Println("告警郵件發(fā)送失敗:", err)
} else {
    fmt.Println("告警郵件發(fā)送成功！")
}

發(fā)送測(cè)試郵件

err := utils.EmailTest("測(cè)試郵件", "<p>這是一封測(cè)試郵件</p>")
if err != nil {
    fmt.Println("測(cè)試郵件發(fā)送失敗:", err)
} else {
    fmt.Println("測(cè)試郵件發(fā)送成功！")
}