讲师中心 微信公众号
AI工具推荐 视频效率加速

Resend API 中 CC/BCC 不生效的常见原因与完整解决方案

秋枫君_4002

秋枫君_4002

发布时间:2026-07-04 17:12:18

|

504人浏览过

|

来源于php中文网

原创

Resend API 中 CC/BCC 不生效的常见原因与完整解决方案

Resend API 的 CC 和 BCC 字段仅在使用已验证域名作为发件人(from)时才生效;若使用未验证的 @resend.dev 或其他未认证邮箱(如含 Cloudflare 邮箱保护的 HTML 标签),系统会静默忽略抄送字段,且不报错。

resend api 的 cc 和 bcc 字段仅在使用已验证域名作为发件人(`from`)时才生效;若使用未验证的 `@resend.dev` 或其他未认证邮箱(如含 cloudflare 邮箱保护的 html 标签),系统会静默忽略抄送字段,且不报错。

在您提供的代码中,问题根源非常明确:当前 from 字段使用的是被 Cloudflare Email Protection 混淆处理的 HTML 链接(例如 <a class="__cf_email__" ...>[email protected]</a>),这根本不是一个有效的纯文本邮箱地址,而是一个前端渲染用的保护性标签。Resend SDK 无法解析该 HTML 片段,导致 from 值实际为空或非法,进而触发 Resend 的安全策略——自动丢弃所有 cc 和 bcc 字段,仅投递至 to 收件人,且不返回错误(符合其“静默降级”设计)。

✅ 正确做法分三步:

1. 使用合法、纯文本的 from 地址

确保 from 是一个格式正确、无 HTML 标签的邮箱,且必须属于您已验证的自定义域名(如 hello@yourdomain.com),不可使用 @resend.dev 免费域(免费版不支持自定义发件域,也禁用 CC/BCC)。
❌ 错误示例(含 HTML、未验证域):

from: '<a class="__cf_email__" data-cfemail="...">[email protected]</a>' // ❌ 无效
from: 'sender@resend.dev' // ❌ 免费版不支持 CC/BCC

✅ 正确示例(纯文本 + 已验证域名):

from: 'newsletter@yourcompany.com' // ✅ 前提:yourcompany.com 已在 Resend 控制台完成 DNS 验证

2. 完成域名验证(必需步骤)

  • 登录 Resend Dashboard → Domains → 点击 Add Domain
  • 输入您的域名(如 yourcompany.com)→ 按指引添加以下 DNS 记录(通常需 TXT 和 CNAME):
    Host: resend._domainkey.yourcompany.com  
    Value: k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...  
    TTL: Auto  
  • 等待 DNS 生效(通常 5–60 分钟),状态变为 Verified 后方可使用。

3. 修正代码:清理输入 & 显式校验

import { Resend } from 'resend';

export default class ResendController {
  static async sendmail(req, res) {
    try {
      const { TO, subject, body, CC, CCO } = req.body;

      // ✅ 强制校验:确保所有邮箱为纯字符串(移除 HTML 标签)
      const cleanEmail = (email) => 
        typeof email === 'string' ? email.replace(/<[^>]*>/g, '').trim() : '';

      const from = cleanEmail(process.env.FROM_EMAIL); // 如 'newsletter@yourcompany.com'
      const to = cleanEmail(TO);
      const cc = CC ? cleanEmail(CC).split(',').map(e => e.trim()).filter(Boolean) : [];
      const bcc = CCO ? cleanEmail(CCO).split(',').map(e => e.trim()).filter(Boolean) : [];

      // ✅ 必须校验 from 是否匹配已验证域名
      if (!from || !from.includes('@yourcompany.com')) {
        return res.status(400).json({ 
          message: 'Invalid "from" address: must be a verified domain email' 
        });
      }

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

      const emailData = {
        from,
        to,
        subject,
        html: body,
        cc: cc.length > 0 ? cc : undefined,   // Resend 接受数组或 undefined
        bcc: bcc.length > 0 ? bcc : undefined
      };

      const emailResponse = await resend.emails.send(emailData);

      res.status(200).json({ 
        message: 'Email sent successfully', 
        id: emailResponse.data?.id 
      });

    } catch (error) {
      console.error('Resend error:', error);
      res.status(500).json({ 
        message: 'Failed to send email', 
        error: error.message 
      });
    }
  }
}

? 关键注意事项:

  • 免费计划限制:Resend 免费层(Free Tier)不支持自定义发件域,因此无法启用 CC/BCC。您必须升级至 Pro 计划($29/月起)并完成域名验证。
  • 邮箱格式规范:cc/bcc 字段接受字符串数组(如 ["a@example.com", "b@example.com"]),不支持逗号拼接的单字符串;若传入字符串,Resend 会静默忽略。
  • 日志排查技巧:在 Resend Dashboard 的 Emails → Logs 中,点击具体邮件 ID,查看 "Recipients" 区域——若只显示 to 而无 cc/bcc,即确认为配置问题而非网络故障。
  • 测试建议:首次验证时,使用 to、cc、bcc 均为自己邮箱,避免因收件方过滤导致误判。

? 总结:Resend 的 CC/BCC 并非“失效”,而是严格依赖可信发件身份。它本质是反垃圾邮件设计——只有经过域名所有权验证的发件人,才被允许扩展投递范围。这不是 Bug,而是安全机制。请务必完成域名验证并升级至付费计划,这是解锁完整邮件功能的唯一路径。

相关文章

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

1995

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2822

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

976

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3179

2025.09.10

ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2480

2023.06.14

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

340

2023.08.31

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2313

2023.11.15

ajax网站有哪些
ajax网站有哪些

使用ajax的网站有谷歌、维基百科、脸书、纽约时报、亚马逊、stackoverflow、twitter、hacker news、shopify和basecamp等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1141

2024.09.24

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

20

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn