邮件发送接口返回500错误主因是net/smtp错误未捕获，如SMTP认证失败、TLS超时、邮箱格式非法等导致smtp.SendMail返回err却未判断，进而引发panic；必须显式if err != nil处理并c.JSON(500, gin.H{"error": err.Error()})返回，同时避免硬编码密码、确保MIME头完整、复用连接并遵守服务商频率限制。
邮件发送接口为什么总返回500错误
多数人在Gin里集成邮件发送时，net/smtp抛出的错误没被正确捕获，直接导致HTTP 500。Gin默认不处理底层IO异常，必须显式用defer+recover或在handler里if err != nil返回具体错误。常见触发点是SMTP认证失败、TLS握手超时、邮箱地址格式非法——这些都会让smtp.SendMail返回非nil错误，但若没检查就继续执行，后续逻辑（比如JSON序列化）可能panic。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 所有
smtp.SendMail调用后必须紧跟if err != nil判断，且用c.JSON(500, gin.H{"error": err.Error()})返回，别用log.Fatal或忽略 - 测试时先用
fmt.Printf("to: %s, err: %v\n", to, err)打印原始错误，SMTP常见错误如dial tcp: lookup smtp.gmail.com: no such host说明DNS失败，535 5.7.8 Username and Password not accepted说明凭据无效 - Gmail等服务商要求开启“应用专用密码”而非账户密码，且需关闭两步验证或单独授权第三方访问
如何安全传入邮箱账号密码而不硬编码
把SMTP_USER和SMTP_PASS写死在代码里等于公开泄露凭证。Gin本身不提供配置管理，得靠外部机制注入。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用环境变量：启动时
SMTP_USER=xxx SMTP_PASS=yyy go run main.go，代码中用os.Getenv("SMTP_USER")读取；注意os.Getenv返回空字符串时要校验，避免传空密码给smtp.Auth - 更稳妥的做法是用
github.com/spf13/viper加载.env文件，但需确保.env不在Git提交中——加到.gitignore并配好viper.AutomaticEnv() - 绝对不要在
gin.Context里存密码，也别从请求参数（如query string）读取密码字段，HTTP明文传输风险极高
发送HTML邮件时为什么收件端显示为纯文本
用text/html内容类型但对方客户端仍当纯文本渲染，通常是邮件头缺失或格式错位。Go标准库net/smtp不自动构造MIME头，全靠手动拼接。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 邮件正文必须包含完整MIME头：
"MIME-Version: 1.0\r\nContent-Type: text/html; charset=\"UTF-8\"\r\n\r\n" + htmlBody，注意两个\r\n分隔头与正文 - 如果要发带附件的邮件，必须用
multipart/mixed，此时需手动生成boundary字符串并按规范拼接各部分——推荐直接用gopkg.in/gomail.v2替代原生net/smtp，它内置MIME封装逻辑 - 测试时用
gmail.com或outlook.com邮箱接收，它们对MIME解析较严格；避免用本地Thunderbird等客户端初测，某些客户端会降级处理
并发发信时连接池不够用怎么办
每次调用smtp.SendMail都新建TCP连接，高并发下容易触发too many open files或SMTP服务器拒绝连接。Gin handler默认每请求起一个goroutine，但net/smtp本身无连接复用机制。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 改用
gomail.NewDialer创建复用连接的gomail.Dialer实例，全局初始化一次（如放在init()或main()里），然后每次发信调用dialer.Dial()获取复用连接 - 设置合理超时：
gomail.NewDialer(host, port, user, pass).SetTimeout(30 * time.Second)，避免慢连接阻塞整个goroutine池 - 如果QPS超过50，建议引入异步队列（如Redis List + worker goroutine），Gin handler只负责入队，避免HTTP请求长时间等待SMTP响应
真正麻烦的是SMTP服务商的频率限制——Gmail免费账号每24小时最多100封，超出直接封禁IP。生产环境必须用SendGrid或Mailgun这类专业服务，并把API密钥存在环境变量里，而不是幻想自己搭SMTP服务器。
