怎样接入欢迎邮件、验证码或通知，并确认真的发成功了？

直接回答

先决定邮件在业务里的作用，再实现发送。欢迎信是注册后的补充，发送失败通常不应把已经成功创建的账号变成注册失败；验证邮件则可能决定后续流程，不能同样处理。Resend 与 React Email 等工具可以分别处理发送服务与邮件模板。实践修正：只 await 发送但不检查返回值会漏掉部分失败；当前官方 Node 示例返回 data 与 error，因此仅加 try/catch 不足以证明发送成功。API 接受、后续投递与用户实际收到也应区分。

适用场景

• 要在注册、订单或任务完成后发送邮件
• 服务端没报错，但用户说没有收到
• 邮件重复发送，或失败影响了主业务

一步一步做

定义邮件类型与触发条件

写明谁在什么事件后收到哪封邮件，是否由用户期待，以及失败时主业务如何处理。补充方法：持续提醒或营销类内容应提供明确的订阅与退出方式，并把用户偏好纳入收件人筛选，不能把所有注册用户默认加入所有群发。

验证发件域名与凭据

按供应商当前要求添加并验证域名记录，保留原有邮箱配置。创建满足发送需求的凭据并放在服务端，不把 Full Access 泛称为仅发送权限。测试发件限制、额度和权限以实际账号为准，不照搬旧免费额度。

先跑通一封测试邮件

使用自己的测试收件地址确认发件人、标题、内容与链接正确。检查服务返回的 data/error 和邮件标识，保存脱敏记录。若 API 返回业务错误，要显式处理，不能等不到异常就认定成功；再检查收件箱及垃圾邮件情况。

接入业务并避免重复

先完成主业务状态，再按需要发送或排队。欢迎信失败可记录并补发，验证码失败则应明确告诉用户下一步。补充方法：使用稳定业务标识和供应商支持的幂等机制，避免页面重复提交或任务补跑导致同一事件多封邮件。

用真实内容检查模板与状态

使用模板机制处理姓名和动态内容，不把未处理的用户文本直接拼成 HTML。检查手机可读性、图片替代信息和按钮链接。对批量发送分别记录成功、失败与跳过，核对退出订阅后是否真的停止对应邮件。

把发送受理、投递和用户收件分别记录

接口返回邮件 ID 表示供应商受理，不表示用户已收到或读过。结合供应商提供的状态记录跟踪投递、退信等结果；投递到收件服务器也不保证进入主收件箱。先用自己的测试地址检查正文、按钮、回复地址和垃圾邮件，再接业务。不能笼统断言网页无法提供系统通知：浏览器支持条件与权限允许时可使用 Web Push；邮件是否合适要看用户场景，不能从该说法推导邮件是唯一渠道。

案例拆解

假设练习：欢迎信失败不等于账号没创建

可以用 try/catch 避免邮件异常拖垮注册。整理补充：先确认发送 SDK 是否通过返回 error 表示失败，并把该结果归入失败处理。假设账号已写入数据库，但邮件域名未验证，应给用户真实的注册成功结果并记录待处理邮件，而不是要求用户反复注册。后续补发只针对未发送成功的同一欢迎事件。

补充假设示例：欢迎信接口返回 ID，测试邮箱没有看到正文。先按该 ID 看供应商状态，再检查地址拼写和垃圾邮件；若已退信就保留失败并修正地址，不显示“用户已阅读”。测试收到后点击链接并回复一次，确认页面和支持邮箱都可用。

行动检查

• 邮件用途、触发条件与用户偏好清楚
• 发件域名已验证且凭据权限适当
• 业务错误和异常都被检查
• 测试邮件实际内容、链接和收件状态已核对
• 失败不误报，重复提交与补跑不重复发送
• 发送受理、供应商投递和实际收件分别记录，回复地址已测试

可复制模板

邮件接入与验收卡

工作模板
邮件类型和触发：［欢迎／验证码／通知／其他］
收件人选择与偏好：［规则］
发件身份：［已验证域名，凭据只填变量名］
主业务关系：［发送失败后是否阻止继续］
动态内容：［字段、模板、链接］
防重复标识：［业务事件规则］
验证：［API data/error、邮件 ID、实际收件、模板、失败和补发］
未确认的投递状态必须保留，不写成全部成功。

单封邮件端到端记录

业务事件ID／测试收件人标识（不写真实私密地址）：
发件人与Reply-To：
API受理时间／邮件ID／data或error：
供应商状态与时间：［已受理／已投递／退信／其他；按官方定义］
测试收件箱观察：［主箱／垃圾箱／未见］
正文、按钮目标、手机显示、回复测试：
主业务是否成功／邮件失败后处理：
重复与退出订阅测试：
可证明的结论／仍未知：

易错点

• 只有 try/catch，没有检查 SDK 的 error 返回值：可能把失败记录为成功。
• 把发信服务当成完整收件邮箱：发信与接收能力需要分别配置和验证。
• 每次接口重试都生成新发送事件：同一业务可能给用户发多封。

相关指南

• 买了域名以后，怎样把它接到网站且不弄坏邮箱？
• 怎样让网站每天自动做一件事，而且不会重复执行或假报成功？
• 怎样收集用户反馈，并决定哪些该修、哪些暂时不做？

官方参考

• Resend：Send Email — 说明 Node 示例的 data/error 返回值和邮件幂等请求头 资料核查记录日期：2026-10-18。

• Resend：Manage API keys — 说明凭据权限与可选域名限制，不能把 Full Access 当成仅发送权限 资料核查记录日期：2026-10-18。

• Resend：Verified Domains — 说明发件域名验证与接收邮件需要分别配置 资料核查记录日期：2026-10-18。

• MDN：Push API — 说明网页可在适用浏览器、订阅与权限条件下使用Push；不宣称所有平台均可用 资料核查记录日期：2026-10-18。

• Resend：Email events — 说明sent与delivered等事件含义；交付服务器不等于进入主收件箱或已读 资料核查记录日期：2026-10-18。