Fiber 无内置邮件模块，需集成 SMTP 客户端（如 gomail.v2）并手写验证码逻辑；标准库 net/smtp 缺乏 MIME 处理、编码和并发控制，易致乱码、拒收或超时；推荐 gomail.v2，注意端口/加密匹配、base64 编码、超时控制及连接复用。

Fiber 没有内置邮件模块，验证码或通知类邮件必须自己集成 SMTP 客户端（如 gomail.v2）并手写校验逻辑——这不是配置问题，而是框架定位决定的：Fiber 只管 HTTP 路由和中间件，不封装业务能力。

为什么直接用 net/smtp 在 Fiber 里发邮件容易失败

标准库 net/smtp 只提供协议传输层，不处理 MIME 结构、编码、换行符或并发控制。在 Fiber 的 handler 中裸调 smtp.SendMail() 会踩一堆坑：

• 中文 Subject 或正文没做 =?UTF-8?B?base64... 编码 → QQ/163 邮箱显示乱码或空主题
• 拼邮件体时用了 \n 而非 \r\n → 多数 SMTP 服务器直接拒收（RFC 2822 强制要求）
• 没设 Content-Transfer-Encoding: base64 + 对应编码正文 → Outlook 解析成源码
• 同步阻塞发送，超时未设 context → 请求卡住，接口响应拖垮整个服务

用 gomail.v2 发带验证码的邮件（推荐方案）

gomail.v2 是目前最轻量、稳定、文档清晰的通用 SMTP 封装，自动处理 MIME、多收件人、附件和编码，适合 Fiber 场景。

• 安装：go get gopkg.in/gomail.v2
• 初始化 Dialer 时注意端口与加密方式匹配：465 → SSL=true，587 → TLS=true
• Subject 必须手动 base64 编码："=?UTF-8?B?" + base64.StdEncoding.EncodeToString([]byte("【验证码】")) + "?="
• 正文建议用 text/plain + base64 编码（比 quoted-printable 更稳，兼容 emoji 和中文标点）
• 别在 handler 里直接 d.DialAndSend(m)，加超时：ctx, cancel := context.WithTimeout(c.Context(), 8*time.Second)，失败返回 503 Service Unavailable

Fiber 中发邮件的典型错误配置

常见失败不是代码写错，而是 SMTP 服务端策略和客户端协议没对齐：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

• Gmail：必须开两步验证 + 生成「应用专用密码」，且只能用 smtp.gmail.com:587 + STARTTLS（不能用 465）
• QQ 邮箱：授权码只对 smtp.qq.com:587（TLS）或 ssl.smtp.qq.com:465（SSL）有效，混用会静默失败
• 企业邮箱（如腾讯企业邮）：默认关闭 SMTP，需后台开启，并用 smtp.exmail.qq.com 域名，不能套用公共版地址
• 国内云服务器（阿里云/腾讯云）：25 端口默认封禁，必须用 465 或 587

验证码流程必须自己补全的三块逻辑

Fiber 不提供任何业务组件，以下环节全得手写：

• 验证码生成：用 rand.Read() + base32 编码，避免 0/O/l/I 等易混淆字符
• 存储与过期：存入 Redis，key 设为 email:verify:to，TTL 设为 5 分钟（redisClient.SetEX(ctx, key, code, 5*time.Minute)）
• 限频防刷：同一 IP 或邮箱 60 秒内最多请求 1 次，用 Redis 的 INCR + EXPIRE 组合实现

最常被忽略的是：SMTP 连接器（gomail.Dialer）不该每次发信都新建——它应该初始化一次，复用连接池；否则高并发下会快速耗尽文件描述符或触发邮箱服务商限流。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！