根本原因是 smtp 服务端配置与 go 客户端行为不匹配：gmail 需开启低安全性访问或应用密码，outlook 需两步验证+应用密码，腾讯企业邮强制 smtp.exmail.qq.com:465+tls；应优先用 smtp.client 手动控制 tls、认证与 mime 构造，避免 smtp.sendmail 的黑盒限制。
为什么 net/smtp 发邮件总卡在认证失败或连接超时？
根本原因通常是 SMTP 服务端配置与 Go 客户端行为不匹配，而非代码写错。比如 Gmail 默认禁用“低安全性应用访问”，Outlook 需开启两步验证并生成应用密码；而国内企业邮箱（如腾讯企业邮）可能强制要求使用 smtp.exmail.qq.com:465 且必须走 TLS，用 :587 + STARTTLS 反而失败。
实操建议：
- 先用
telnet smtp.example.com 465或openssl s_client -connect smtp.example.com:465 -crlf确认端口可达、证书有效 - 不要硬编码账号密码，改用环境变量读取：
os.Getenv("SMTP_USER")和os.Getenv("SMTP_PASS") - 避免直接调用
smtp.SendMail—— 它不支持自定义 TLS 配置，遇到证书校验或协议协商问题几乎无法调试
如何正确建立带 TLS 的 SMTP 连接并发送带附件的邮件？
必须手动创建 smtp.Client 实例，才能控制 TLS 配置、执行 Auth、处理 MAIL FROM / RCPT TO 等步骤。附件需手动构造 MIME 多部分结构，net/smtp 不提供高层封装。
关键点：
- 对 465 端口：用
tls.Dial建立加密连接后，再用smtp.NewClient包装；对 587 端口：先普通net.Dial，再调c.StartTLS - 认证方式优先选
smtp.PlainAuth，Gmail/Outlook/QQ 都支持；smtp.CRAMMD5Auth基本已淘汰，别用 - 发件人地址必须和认证账号一致，否则多数服务商拒绝中继，错误信息类似
530 5.7.0 Must issue a STARTTLS command first或535 5.7.8 Authentication failed - 附件要自己写 MIME boundary、设置
Content-Type和Content-Transfer-Encoding: base64，推荐用mime/multipart包构建*multipart.Writer
smtp.SendMail 和手动 smtp.Client 的性能与可靠性差异在哪？
smtp.SendMail 是同步阻塞调用，内部新建连接、认证、发送、关闭，适合单次轻量任务；但每发一封都重建 TCP+TLS，高并发下会触发连接数限制或耗尽本地端口。手动管理 smtp.Client 可复用连接（需注意并发安全），也便于插入日志、重试逻辑、超时控制。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
实际选择依据：
- 定时通知类（如日志告警）：用
smtp.SendMail足够，代码少、逻辑清晰 - 用户注册邮件、订单通知等高频场景：必须用
smtp.Client+ 连接池（自己实现简单池或用第三方如gomail） - 需要细粒度错误分类（如区分认证失败、收件人拒收、发信配额超限）：只有手动流程能拿到各阶段返回码，
SendMail只返回一个error - 超时控制：
SendMail依赖底层net.DialTimeout，无法单独设认证超时或发送超时；手动流程可对每个c.Auth、c.Mail、c.Send单独加 context
国内 SMTP 服务商常见坑点与绕过方式
腾讯企业邮、阿里云邮件推送、网易企业邮对 Go 客户端有隐性限制：比如要求 HELO 域名是真实域名、User-Agent 被过滤、IP 被加入白名单前发信被限频。这些不会报错，只会静默丢弃或延迟投递。
排查和应对：
- 启用 SMTP 调试日志：在
smtp.Client创建后调用c.SetDebugWriter(os.Stdout)，观察实际交互命令和响应码 - HELO/EHLO 域名必须是合法域名（不能是
localhost），可用c.Hello("example.com")显式设置 - 阿里云邮件推送要求发信地址必须提前在控制台验证，且
From字段必须和验证地址完全一致（包括大小写），否则返回553 Mail from address must be same as authorization user - 如果用公司内网 IP 发信，大概率被腾讯/网易拉黑，必须走代理或换用已备案的云服务器出口 IP
真正难的不是写通第一封邮件，而是让每一封都稳定进收件箱——这取决于你是否愿意花十分钟看一眼服务商文档里的“接入规范”小字部分。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
