搞开发的人应该都懂,项目里最烦的往往不是核心业务逻辑,而是那些看起来不起眼的支线功能。比如“给用户发一封邮件通知”、“给管理员发一条短信告警”,需求一句话,落地一大堆。尤其是在做自动化流程、后台管理系统、运维告警、用户注册验证码这类场景时,发送邮件和短信几乎是绕不开的标配。我最近重构了一套消息通知模块,把邮件和短信的发送逻辑都重新梳理了一遍,过程中踩了不少坑,也整理出一些可以直接抄作业的代码和配置思路。这篇就专门聊聊,从零开始接邮件和短信通道,到底该怎么选型、怎么写代码、怎么排查问题。
这篇文章适合正在开发后台系统、自动化脚本、定时任务,或者用 n8n 这类工具做工作流自动化的朋友。不管你是写 Python、Java、.NET 还是 Node.js,核心原理是共通的,我会给出一套尽量通用的方案,再用具体代码演示落地过程。后面还会专门整理“邮件被拒收”“报 authentication failed”“短信发送成功但用户收不到”这类高频问题的排查方法,这些内容平时文档里不一定写得很细,却是真正影响线上体验的部分。
1. 先把需求说清楚,流程才不会绕远路
很多人在写发送邮件或短信的代码之前,习惯直接打开编辑器写一个 sendMail() 函数。我建议先停下来,把需求拆成几个维度想清楚,不然很容易写完才发现选错了服务商或者漏掉了关键配置。以下是我在实际项目里用来判断技术方案的四个维度。
1.1 场景盘点:你到底是哪一种“发邮件”
同样是“发送邮件”,不同场景对技术方案的要求完全不同。以我的经验,大致可以分为三类。
第一类是事务性邮件,比如用户注册后的验证邮件、密码重置邮件、订单状态变更通知。这类邮件要求时效性高、到达率高、不能进垃圾箱,对失败需要重试机制。第二类是订阅性邮件,比如周报、月刊、营销活动邮件,这种更看重发送量和退订管理,通常不适合用普通邮箱账号直接发。第三类是系统告警邮件,比如服务器负载超标、定时任务失败、接口报错,这类邮件往往是由脚本或自动化工作流触发,量不大但必须稳定。
对应到技术选型上,如果只是内部系统给管理员发个告警,用企业邮箱的 SMTP 就能解决;如果是给海量注册用户发验证码,我就建议直接用专门的事务邮件服务商,别自己搭邮件服务器,也别用个人邮箱扛量。
短信的场景分类也类似。验证码短信对到达率极其敏感,用户等着登录,结果短信几分钟不到,体验就直接崩了。通知类短信如物流提醒、还款提醒,允许有短暂延迟但必须有发送状态回执。营销短信则是另一个世界,需要报备模板、限制发送时间、处理退订,通常价格也更低。不同类型的短信,选择的 API 服务商和代码写法会有差别,提前分清能少走弯路。
1.2 选型三问:服务商、协议、触发入口
想清楚需求之后,我一般会问自己三个问题。
第一个问题,用谁的通道?邮件方面,如果公司有企业邮箱,直接用它的 SMTP 服务器是最低成本方案;如果没有,或者量比较大,就考虑专门的事务邮件服务。短信方面,国内常见的做法是接阿里云短信、腾讯云短信这类大厂 API,海外项目则会用 Twilio、MessageBird 等。选型的核心指标是到达率、价格、稳定性和技术支持响应速度。
第二个问题,用什么协议或 API?邮件的基础协议是 SMTP,这是必须要懂的。短信没有类似 SMTP 的标准协议,基本是各家服务商的 HTTP API,格式大同小异,但鉴权方式、签名规则各不相同,换服务商意味着代码也要跟着改。
第三个问题,触发入口在哪里?是在用户注册流程里同步触发,还是在后台管理界面手动点击发送,还是由定时任务批量执行?这个决定了代码里要不要做异步队列、要不要做失败重试、要不要控制发送频率。我之前见过一个项目,直接在用户注册的同步逻辑里调 HTTP 接口发短信,高峰时期一个注册请求要卡住好几秒,后来改成消息队列异步消费才解决问题。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 邮件发送:协议、鉴权与代码实现
邮件这块的核心是 SMTP。不理解 SMTP,写出来的代码基本是照抄别人的配置,一旦报错就手足无措。所以这一节先从协议原理讲起,再给具体实现代码。
2.1 SMTP 的核心概念:端口、TLS/SSL、从邮箱账号到代码配置
SMTP(Simple Mail Transfer Protocol)是邮件传输的标准协议,它定义了邮件从客户端到服务器、以及服务器之间转发邮件的规则。我们写代码时,做的事情其实就是“以某个邮箱账号的身份,通过 SMTP 服务器把邮件投递出去”。
一个典型的 SMTP 配置包含四个要素:
- 服务器地址,如
smtp.example.com - 端口,常见的是 25、465、587
- 加密方式,SSL 或 STARTTLS
- 账号和密码,注意不是邮箱登录密码,很多厂商要求使用专门的“授权码”
端口和加密方式之间的关系,是新手最容易搞混的地方。我习惯用一个表格来记忆:
| 端口 | 加密方式 | 常见用途 |
|---|---|---|
| 25 | 无(明文) | 服务器之间转发,通常被云厂商封禁,不适合客户端用 |
| 465 | SSL/TLS(隐式加密) | 常见于企业邮箱 SMTP |
| 587 | STARTTLS(显式升级加密) | 多数现代邮箱推荐使用 |
为什么现在推荐用 587?因为 25 端口被大量利用来发送垃圾邮件,主流云厂商基本都会屏蔽出站 25 端口。587 和 465 都支持加密传输,区别在于 465 是一上来就加密,587 是先明文连接再通过 STARTTLS 升级为加密通道。在代码里,两个端口对应的 socket 处理方式不同,这是我见过最大的一类报错来源。
代码层面,还有一个很关键的参数:邮件发送方的“显示名称”和“信封地址”。不要小看这个东西,发件人名称里的中文字符如果没用 Base64 编码,经常会被对方服务器识别为乱码或直接丢
