用HTTP接口发送邮件验证码免自建SMTP

说句实在话，注册、登录、操作确认，只要涉及到验证身份，背后都少不了那个发验证码邮件的动作。这事儿本身不难，难的是把它做稳。自己搭 SMTP 的话，通常会遇到这么几个问题：邮箱服务申请和配置成本、SPF/DKIM/DMARC 没配好邮件直接进垃圾箱、送达率不可控，还得自己实现失败重试、并发控制和频率限制。发量一上来，通道稳定性和封号风险也跟着冒头。这些全是基础设施层面的活儿，跟业务逻辑八竿子打不着，却要持续往里搭精力。所以一个更省事的做法是：把"发送"这一层交出去，用现成的接口搞定。

背景与问题

发送验证码邮件，发送动作本身不复杂，难的是稳定。自己搞 SMTP，得面对这些：

• 邮箱服务与 SMTP 的申请、配置成本
• SPF / DKIM / DMARC 没配好，邮件进垃圾箱，送达率无法保证
• 发送失败的重试、并发与频率控制需要自己实现
• 发送量增长后的通道稳定性和封号风险

这些都属于基础设施层面的事，跟业务没有直接关系，却要持续投入维护。所以更聪明的做法，是把"发送"这个环节外包出去，用现成的接口。

方案

整体思路是职责拆分：

• 业务侧（你的后端）负责：生成验证码、存储（比如 Redis 带过期时间）、校验
• 发送侧（外部接口）负责：邮件投递、模板渲染、送达通道

这次用的是现成的邮件推送服务（Spug），调用方式是一个 HTTP POST，模板编码就是凭证，没有额外的鉴权流程，接入成本确实很低。

实现步骤

获取模板编码

微信扫码登录后进入「邮件模板」，系统默认提供一个验证码模板，复制它的模板编码（长这样：Ne6Wq3pV7mD）。这个编码就是调用凭证，不需要申请 token 或签名，直接用。

调用接口

模板编码放在接口路径末尾，提交收件人和模板变量：

curl -d '{"to": "svc@example.com", "scene": "操作确认", "code": "330948", "minute": "5"}' https://push.spug.cc/mail/Ne6Wq3pV7mD

后端建议封装成一个独立方法，方便统一处理超时和异常：

import requests
PUSH_URL = 'https://push.spug.cc/mail/Ne6Wq3pV7mD'
def send_verify_code(to_email, code, scene='操作确认', minute='5'):
body = { 'to': to_email, 'scene': scene, 'code': code, 'minute': minute }
try:
resp = requests.post(PUSH_URL, json=body, timeout=5)
data = resp.json()
except requests.RequestException:
# 发送失败不应阻塞主流程，记录日志并允许用户重发即可
return None
return data.get('request_id')

参数

默认模板正文：

您正在进行${scene}，本次验证码为：${code}请在 ${minute} 分钟内输入验证码完成验证。

结果验证

请求成功返回：

{ "code": 200, "msg": "请求成功", "request_id": "dwezjVRDoe5jgLkR"}

这里需要特别澄清一下：code=200 只表示请求被接收并入库成功，但邮件是异步发送的，200 并不等于已经送达。要确认实际发送状态，得用返回的 request_id 到推送日志中查询。建议把 request_id 与收件人、发送时间一并落库，作为排查依据——用户反馈没收到时，就能直接定位这封邮件的状态，多数情况其实是被收件方归入垃圾箱了。

常见问题

模板编码可以下发到前端吗？
不建议。模板编码等同于调用凭证，暴露后别人可以消耗你的发送额度。只在服务端调用就好；如果服务端 IP 固定，推荐配置 IP 白名单。怀疑泄露时在平台重置编码，旧编码会立即失效。

发送失败怎么处理？
发送是外部网络调用，必须设置超时并捕获异常。失败时记录日志并允许用户重发，避免阻塞注册或登录的主流程。

能自定义邮件内容吗？
可以。新建自定义模板后，按模板详情里列出的变量传参就行。

写在最后

把邮件发送变成一次 HTTP 调用之后，后端的代码更聚焦，送达和通道维护也不用自己扛。需要注意的主要是两点：返回 200 只是入库成功，邮件是异步发送的；模板编码必须留在服务端，不能暴露出去。