使用 Resend 发送事务性邮件

用你自己的域名

邮件应该从你拥有的域名发出——[email protected]，而不是 [email protected]。原因有两个：

• 信任感。收件人看到的是"来自你的真实品牌"，而不是"来自一个任何人都能注册的免费邮箱"。
• 送达率。自己掌控的域名可以配置 SPF/DKIM/DMARC 记录；免费邮箱地址做不到这一点。

还没有域名的话，请参阅域名注册教程。你也可以使用专门用于事务邮件的子域名——比如 mail.yourapp.com 或 notifications.yourapp.com——这是个好习惯，因为它能将发件信誉与根域名上的其他业务隔离开来。

在 resend.com 注册

注册账号。免费套餐提供每月 3,000 封、每日 100 封的发送量，发件地址是共享的 [email protected]。这足够用来测试 SDK，但不适合对外发给真实用户——因为 resend.dev 发出的邮件看起来不像是来自你的品牌，收件人可能会产生疑虑。

要用自己的域名发件，就需要先添加并验证域名，这就是下一步的内容。

Resend → Domains → Add Domain

点击 Add Domain，输入你要用于发件的域名（或子域名），点击 Add。Resend 会列出需要添加的 DNS 记录，通常有 3 到 5 条：一条 SPF、两到三条 DKIM（取决于配置）、可选的 DMARC，以及一条 MX 记录（如果你希望退信通知也通过 Resend 接收的话）。

这些记录看起来有些复杂，但你不需要理解背后的密码学原理——只需逐条原样复制到你的 DNS 服务商即可。

严格按照 Resend 的说明操作

对于 Resend 列出的每条记录，前往你的 DNS 服务商（如需了解 DNS 操作，请参阅 DNS 教程），依次添加：

• 类型（Type）：与 Resend 显示的一致（TXT、CNAME、MX 等）。
• 名称/主机（Name/Host）：完全一致。不同服务商格式略有差异，有的只需填 resend，有的需要填 resend.yourdomain.com，保持一致即可。
• 值（Value）：原样粘贴，注意不要有多余空格——DNS 的值是精确字符串。
• TTL：默认值即可。

全部添加完成后，在 Resend 中点击 Verify DNS Records。DNS 生效可能需要几分钟到几小时不等。Resend 会自动定期重新检查，所有记录解析正常后会显示"已验证"状态。

Resend → API Keys → Create

点击 Create API Key，为密钥命名（例如"production"），选择权限（通常选 Sending access——限制权限比完全访问更安全）。复制密钥（re_…），它只显示这一次。

将其写入后端的环境文件：RESEND_API_KEY=re_…。和往常一样，不要提交到 git。

SDK 调用方式

在项目中安装 SDK：

npm install resend
# or: pip install resend, or: gem install resend

发送一封测试邮件：

import { Resend } from 'resend';

const resend = new Resend(process.env.RESEND_API_KEY);

await resend.emails.send({
  from: 'You <[email protected]>',
  to: ['[email protected]'],
  subject: 'Hello from Resend',
  html: '<p>This is the body of the email.</p>',
});

查看收件箱。如果邮件到达，说明配置成功。如果没有收到，打开 Resend 仪表板的 Emails 日志——它记录了每次发送尝试及其状态（已送达、退信、进入垃圾箱等）以及接收方的响应信息。

或者直接用你喜欢的 HTML

对于一次性邮件，直接写 HTML 字符串完全够用。但对于需要反复发送的内容（欢迎邮件、收据、密码重置），使用模板会更省心。Resend 官方推荐的方案是 React Email——把邮件写成 React 组件，发送时渲染为 HTML。

import { Resend } from 'resend';
import { ReceiptEmail } from './emails/Receipt';

await resend.emails.send({
  from: 'Receipts <[email protected]>',
  to: customer.email,
  subject: `Receipt for $${amount}`,
  react: ReceiptEmail({ customerName: customer.name, amount, items }),
});

React Email 组件提供了邮件安全的原生元素（<Container>、<Text>、<Button>），最终渲染为邮件客户端所要求的基于表格的 HTML。你写现代 JSX，库来处理那些复古的底层标记。

送达率排查清单

邮件进垃圾箱，通常是以下原因之一：

• DNS 记录未完全验证。检查 Resend 仪表板。可能部分记录已生效，部分还没有。所有记录都必须变为绿色。
• 发件域名与 DKIM 域名不一致。如果你为 mail.yourdomain.com 配置了 DKIM，却从 [email protected] 发件，DKIM 签名无法授权这个 From 地址。要么改为从 [email protected] 发件，要么为根域名单独配置 DKIM。
• 邮件内容看起来像垃圾邮件。全大写、大量"FREE!!!"、过多 emoji、可疑的链接模式。用 mail-tester.com 测试——它会给出评分并解释扣分原因。
• 域名太新、发送量太大。新域名没有发件信誉，邮件服务商会保持警惕，直到你持续发出看起来正常的邮件一到两周。发送量要循序渐进地提升。