0

0

如何在 Go 中通过 SMTP 发送邮件并自定义发件人名称

聖光之護

聖光之護

发布时间:2025-12-29 18:03:58

|

263人浏览过

|

来源于php中文网

原创

如何在 Go 中通过 SMTP 发送邮件并自定义发件人名称

go 中使用标准库 `net/smtp` 发送邮件时,`client.mail()` 仅接受纯邮箱地址作为参数,而显示给收件人的“发件人名称”需通过邮件头(`from` 字段)设置为 `"姓名 "` 格式,二者必须分离处理。

Go 的标准 net/smtp 包要求严格区分SMTP 协议层的发件人身份(用于认证与投递校验)和邮件内容层的显示发件人(用于收件人界面展示)。若将 "Sandy Sender " 直接传入 Client.Mail(),SMTP 服务器会因格式非法返回 501 5.1.7 Invalid address 错误——因为协议层只允许 RFC 5321 兼容的纯邮箱地址(如 或 user@example.com),不支持带名称的 name 格式。

✅ 正确做法是 “双轨设置”

  • Client.Mail() 参数:仅传入纯邮箱地址(如 "user@example.com"),用于 SMTP 认证与路由;
  • 邮件正文头部(Header):在构造的邮件内容中显式写入 From: Sandy Sender 行,该字段控制客户端显示效果。

以下是一个完整、可运行的标准库示例(使用 strings.Reader 构造原始邮件):

package main

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

func main() {
    // SMTP 配置
    auth := smtp.PlainAuth("", "user@example.com", "app-password", "smtp.example.com")

    // 构造符合 RFC 5322 的原始邮件(注意:From 头含名称)
    msg := strings.NewReader(`From: Sandy Sender 
To: recipient@example.com
Subject: Hello from Go!
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"

This is the body of the message.
`)

    // 关键:Client.Mail() 只传纯邮箱地址(无名称!)
    err := smtp.SendMail(
        "smtp.example.com:587",
        auth,
        "user@example.com",           // ← 必须是纯邮箱(与 From 头中的地址一致)
        []string{"recipient@example.com"},
        msg,
    )
    if err != nil {
        panic(fmt.Sprintf("failed to send email: %v", err))
    }
    fmt.Println("Email sent successfully!")
}

⚠️ 注意事项:

Z Code
Z Code

智谱AI推出的轻量级AI代码编辑器

下载
  • Client.Mail() 的 from 参数与 From: 邮件头中的邮箱地址必须完全一致(忽略大小写),否则部分 SMTP 服务(如 Gmail、Outlook)会拒绝投递或标记为伪造;
  • 名称部分(如 Sandy Sender)仅影响收件端显示,不参与 SMTP 认证,因此不能包含特殊字符(建议仅用 ASCII 字母、空格、连字符);
  • 若需更健壮的邮件构建能力(如附件、HTML 正文、多收件人、自动 MIME 编码),推荐使用成熟第三方库,例如 gomail(v2):
m := gomail.NewMessage()
m.SetAddressHeader("From", "user@example.com", "Sandy Sender") // 自动组装为 "Sandy Sender "
m.SetAddressHeader("To", "recipient@example.com", "")
m.SetHeader("Subject", "Hello!")
m.SetBody("text/plain", "This is the body.")
// ... 发送逻辑

gomail 内部已封装上述分离逻辑,开发者无需手动拼接原始邮件,显著降低出错风险。

总结:Go 原生 SMTP 发送邮件时,“显示名称”与“协议发件人”必须解耦处理——前者写入邮件头 From 字段,后者单独传入 Client.Mail()。理解这一分层设计,是实现专业邮件发送的关键基础。

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

591

2023.06.14

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

637

2023.06.21

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

458

2023.07.31

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

240

2023.08.01

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2849

2023.08.11

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

500

2023.08.11

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

306

2023.08.31

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

417

2023.09.01

俄罗斯搜索引擎Yandex最新官方入口网址
俄罗斯搜索引擎Yandex最新官方入口网址

Yandex官方入口网址是https://yandex.com;用户可通过网页端直连或移动端浏览器直接访问,无需登录即可使用搜索、图片、新闻、地图等全部基础功能,并支持多语种检索与静态资源精准筛选。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1

2025.12.29

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.7万人学习

AngularJS教程
AngularJS教程

共24课时 | 2.1万人学习

CSS教程
CSS教程

共754课时 | 17万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号