阿里云邮件推送常用于网站验证码、订单通知和账单提醒。配置完成后,接口显示发送成功,邮件却可能进垃圾箱,甚至收件人完全收不到。遇到这类情况,通常要一起检查域名验证、发件地址、邮件认证、内容和程序发送逻辑,单看接口返回状态不够。
设置前先确认邮件的用途和触发方式。验证码看重及时性,订单通知需要能对应具体业务记录;营销邮件则要处理用户授权和退订,不能直接套用事务通知的发送方式。把这些场景分清楚,后续选接入方式、写模板和设发送频率时会更有针对性。
先选 SMTP 或 API 接入
阿里云邮件推送可通过控制台配置,再使用 SMTP 或 API 接入。已有系统支持标准邮件协议、希望较快接入时,可以考虑 SMTP;需要在程序中管理发送参数、处理接口返回结果并记录日志时,API 通常更方便。具体功能、服务器地址和参数,以当前控制台文档为准。
无论使用哪种方式,都不要把访问密钥或 SMTP 凭据放进公开代码仓库、网页前端或客户端程序。将凭据保存在服务端配置或密钥管理系统中,并区分测试与生产环境,避免测试配置误用于正式发送。
验证发信域名并配置发件地址
- 准备可管理的发信域名。如果主站使用 example.com,可以考虑使用 mail.example.com 作为邮件相关域名。单独管理发信域名,有助于区分邮件业务与网站配置;前提是你拥有该域名,并能修改它的 DNS 记录。
- 在控制台添加域名。按页面提示完成域名验证。需要添加的记录类型、主机记录和值,以控制台显示为准,不要根据其他域名的配置猜测填写。
- 到实际的 DNS 服务商处添加记录。域名 DNS 不一定托管在阿里云。如果使用其他服务商,需要登录对应平台修改记录。保存后等待解析生效,再回到控制台检查验证状态。
- 设置发信地址和显示名称。例如使用 notify@mail.example.com,并选择能让收件人认出业务来源的显示名称。避免使用含糊或容易被误认为广告的发件人名称。
域名验证一直未通过时,先检查主机记录有没有重复添加域名后缀、记录值是否带入空格,以及记录是否加在实际生效的 DNS 平台。确认记录能公开解析后,再等一段时间回控制台检查;不同服务商的解析生效时间可能不同。
检查 SPF、DKIM 和 DMARC
邮件认证记录可以帮助收件方判断邮件是否由获授权的系统发送。控制台可能会提供 SPF、DKIM 等记录;部分场景也可以配置 DMARC。按控制台给出的记录操作,并在修改前弄清域名上已有的邮件配置。
- SPF:用于声明哪些服务器可以代表域名发信。如果域名已经有 SPF 记录,不要再新建一条互相冲突的记录。先检查现有授权内容,再按规范合并需要的发信来源。
- DKIM:通过数字签名帮助验证邮件内容和发件域名。复制控制台提供的主机记录与公钥值时,要留意记录类型和选择器名称,避免漏字或填错。
- DMARC:用于发布域名的邮件处理策略和报告要求。配置前先确认网站、客服系统及其他发信服务的邮件来源,避免策略过严,导致合法邮件也受到影响。
不要为了让某项检查通过,就随意删除原有 DNS 记录。一个域名可能同时服务于网站、企业邮箱和其他发信系统;修改前先确认记录用途,尤其要避免影响正常收信。
准备模板并完成程序接入
邮件主题、正文和变量应在上线前逐项检查。验证码邮件要让人一眼看到验证码及有效时间,别在主题里写促销口号、正文里却只放一串验证码。订单通知应包含处理业务所需的信息,并提供可访问的业务入口。使用模板变量时,确认程序传入的字段名称与模板配置一致,避免缺少变量后内容异常或发送失败。
使用 SMTP 时,按控制台信息配置服务器地址、端口、加密方式和认证凭据;使用 API 时,则根据对应接口文档配置请求参数、签名或 SDK。不要直接照搬其他云厂商的地址和参数。正式切换前,先在测试环境完成实际收件测试。
程序端也要处理发送结果。建议记录请求时间、业务编号和平台返回状态;发送失败时采用有限次数的重试,并设置合适的间隔。验证码邮件还应限制短时间内的重复发送,防止用户连续点击造成邮件轰炸,也降低接口被滥用的风险。
案例:验证码发送成功,收件人却没看到
一家在线预约平台接入邮件推送后,接口返回成功,但有用户反馈没有收到验证码。排查发现,团队只完成了发信域名验证,没有按控制台要求配置 DKIM;邮件主题写着“限时福利:立即领取”,正文却只有验证码,主题和内容对不上。
团队补齐认证记录并确认 DNS 生效后,把主题改为“预约平台登录验证码”,在正文中说明验证码的用途和有效时间,同时删除无关促销措辞。程序端也增加了发送日志和失败告警,并为同一邮箱设置合理的重发间隔。调整后,他们通过不同邮箱服务商测试,并持续留意退信、投诉和送达情况。这个例子说明,接口返回成功只代表请求得到处理,不能据此判断邮件一定进入收件箱。
上线前逐项核对
- 发信域名已完成控制台验证,DNS 记录与页面要求一致。
- 发件地址稳定可识别,SPF、DKIM 等认证记录已按需配置。
- SMTP 或 API 参数来自当前控制台文档,凭据保存在服务端。
- 主题、正文、模板变量和收件地址都经过实际测试。
- 程序能记录发送结果、处理异常,并限制重试与重复发送。
- 发送对象符合用户授权、退订和数据保护要求,不向未经同意的对象批量发送邮件。
阿里云邮件推送设置完成后,还要结合平台状态、程序日志、退信信息和收件方反馈观察实际表现。遇到送达问题时,按这些线索逐项排查,比只看“接口成功”更容易找到原因。