邮件发不出去,问题未必出在发送代码。域名归属、发件地址、认证记录和收件人管理,都会影响邮件能否正常送达。阿里云邮件推送可用于验证码、订单通知和账单提醒等业务邮件。配置时按部署顺序逐项验证,比一开始就接入生产流量更容易定位问题。
本文以验证码邮件为例,梳理阿里云邮件推送配置中的域名验证、接入方式和送达检查。控制台菜单、配额及验证要求可能调整,实际操作请以当前控制台和产品文档为准。
配置前准备好三项信息
- 可管理 DNS 的域名:你需要能在域名服务商或 DNS 控制台添加记录。可以考虑使用专门的发信子域名,例如 mail.example.com,把业务邮件与网站主域名区分开。
- 发件地址:提前确定用于显示的地址,例如 notice@mail.example.com,并确认回复地址是否需要单独设置。发件地址须符合控制台的验证要求。
- 接入方式和发送场景:确认应用使用 SMTP 还是 API,并估算发送量、邮件类型和触发时机。验证码与账单通知的触发频率、失败处理方式可能不同,最好在接入前就规划好。
多人协作时,可由具备必要权限的 RAM 用户完成配置。主账号凭证和服务访问密钥不要放进代码仓库、工单或聊天记录。
在控制台验证域名和发件身份
添加发信域名及 DNS 记录
进入阿里云邮件推送控制台,找到发信域名设置,添加准备使用的域名或子域名。控制台会提供用于验证域名归属及邮件认证的 DNS 记录。按页面给出的记录名称、类型和值,到 DNS 服务商处逐项添加。
记录内容不要凭经验修改。不同服务商对“主机记录”的填写方式可能不同,尤其要留意系统是否会自动补上域名后缀。添加后等待解析生效,再返回控制台验证。若验证失败,检查记录是否加在正确的 DNS 区域、主机名是否重复拼接,以及记录值是否带入了空格等多余字符。DNS 缓存需要时间更新,刚添加就反复删除重建,反而会增加排查难度。
检查发件地址和邮件认证
域名通过验证后,按控制台流程创建或验证发件地址。还要核对 SPF、DKIM 等邮件认证记录。SPF 用于声明哪些服务获准代表域名发送邮件,DKIM 则为邮件提供签名验证。如果域名已经设置 DMARC,也要确认策略与当前发信配置兼容。
特别注意 SPF:同一个域名通常需要把获准的发信服务整合到一条 SPF 策略中,不要未经检查就新增一条,也不要覆盖现有记录。配置完成后,可使用控制台提供的验证能力或邮件检测工具检查解析结果,再向常用邮箱发送测试邮件,确认邮件是进入收件箱、被放入垃圾邮件,还是遭到拒收。
根据应用选择 SMTP 或 API
SMTP 适合已有邮件组件或框架、希望通过标准邮件协议发送的项目。接入时需配置控制台提供的 SMTP 主机、端口、加密方式和认证信息。端口及连接要求以当前产品文档为准,生产环境应使用产品支持的加密连接。
API 更适合需要在应用中记录请求结果、处理返回状态或与云上服务集成的场景。按官方 SDK 或接口文档设置地域、服务地址和凭证,并在程序中处理超时、限流和失败重试。若项目已有成熟的邮件协议组件,SMTP 可能更容易接入;如果需要细致处理接口返回结果,API 往往更便于和业务流程衔接。
无论选哪种方式,都应使用独立的服务凭证,并通过环境变量或密钥管理服务注入。不要把 AccessKey 或 SMTP 密码写在前端、公开仓库和普通日志里。发现凭证可能泄露时,应及时轮换,并检查近期发送记录。
用验证码邮件验证完整链路
例如,某电商网站要发送登录验证码,计划使用 notice@mail.example.com。团队先在控制台验证 mail.example.com,按要求添加 DNS 记录并完成认证,再创建发件地址。应用选择 API 接入后,将凭证保存在服务端的安全配置中。用户请求验证码时,由后端生成短时有效的随机码并调用邮件推送服务;接口返回后记录请求结果,但不要在普通日志中保存验证码明文。
上线前至少测试正常收件、无效邮箱和服务调用失败三种情况。发送失败时,应向用户给出明确提示;重试要有次数上限和间隔,避免服务故障时反复投递。验证码还需要设置有效期,并限制单个账号或 IP 的发送频率,防止用户连续点击造成重复发送。测试环境最好使用单独的发信地址和接收名单,避免邮件误发给真实用户。
送达率、名单与发送量管理
接口调用成功,只能说明请求已被服务接受,不能保证邮件一定进入收件箱。收件方可能因为地址无效、认证不完整、邮件内容特征或发信信誉等原因退信,或将邮件放入垃圾邮件。初次上线应从小规模发送开始,持续查看发送结果、退信和投诉情况,再根据实际表现调整。
不要购买或导入来源不明的邮箱名单,也不要把营销内容伪装成系统通知。发送订阅类邮件前,应取得适当授权,提供清楚的退订方式,并及时停止向已退订地址发送。系统通知和营销邮件最好分开管理,主题、发件人名称和正文都要让收件人看得明白。
发送量较大时,先确认产品配额、频率限制和申请条件。测试额度不一定能满足生产需求,不能等到业务上线后才发现发送量受限。
上线前检查清单
- 发信域名和发件地址已按控制台要求完成验证。
- DNS 认证记录与控制台提供的内容一致,且没有误覆盖现有解析策略。
- SMTP 或 API 参数正确,凭证只保存在服务端的安全位置。
- 已测试正常发送、无效邮箱、失败处理和重复请求。
- 已设置发送频率限制,并明确退订、投诉和发送数据的监控方式。
阿里云邮件推送配置完成后,建议先用小流量验证整条发信链路,再逐步接入真实业务。域名认证、接口调用、异常处理和收件人管理都检查到位,出现退信或投诉时也更容易找到原因。