SharePoint SPFx React项目使用PNPjs发邮件时CC/BCC不生效求助

可能的原因 #

• 自定义参数类型与pnpjs要求的结构不匹配：你自行定义的EmailProperties接口中CC、BCC字段名不符合pnpjs官方的入参要求，pnpjs处理参数时识别不到这两个字段，就会直接忽略抄送、密送地址，仅发送给To字段的收件人。
• 异步调用未捕获异常：当前submitNewForm是async函数，但调用sp.utility.sendEmail时没有加await，仅用.then处理成功回调，此时该方法抛出的异常不会进入你编写的try/catch块，你无法感知到潜在的参数错误。
• sp-pnp-js版本兼容问题：不同版本的sp-pnp-js对sendEmail的入参结构定义有差异，如果你的依赖版本和参考的文档版本不匹配，也会导致字段不生效。
• SharePoint服务端过滤：部分SharePoint租户的邮件策略会对抄送/密送的外部邮箱做额外校验，可能出现To字段的外部邮箱可正常发送，但抄送/密送的外部邮箱被服务端静默过滤的情况。

调试定位方法 #

• 替换自定义类型为pnpjs官方类型：移除自行定义的EmailProperties接口，改为从pnpjs的utility模块引入官方提供的EmailProperties类型，避免字段名、结构写错的问题。
• 补全异步异常捕获：给sp.utility.sendEmail调用加上await关键字，同时补全catch块的错误打印逻辑，确认是否有隐藏的参数报错。修改后的核心代码参考：

async submitNewForm():Promise<any> {
    try {       
        // 省略其他逻辑代码
        const emailProps: EmailProperties = {
            To: ["emailhere@gmail.com"],
            // 此处字段名要和官方类型定义保持一致
            Cc: ["cchere@gmail.com"],
            Subject: "Title Here",
            Body: `body code here`
        };
        await sp.utility.sendEmail(emailProps);
        console.log("Email Sent to user!");
    } catch(error) {
        // 打印完整错误信息
        console.error("邮件发送错误：", error);
    }
}

• 抓包查看接口请求：打开浏览器开发者工具的网络面板，复现发送操作，找到调用_api/SP.Utilities.Utility.SendEmail的请求，查看请求Payload里是否包含了CC、BCC对应的地址信息：如果请求里没有对应字段，说明是前端传参错误；如果请求里已经携带了对应字段，说明是SharePoint服务端过滤导致。
• 查看SharePoint邮件日志：联系租户管理员在SharePoint管理中心查看邮件发送日志，确认对应邮件的收件人列表是否包含你填写的抄送、密送地址，即可判断是发送阶段未加对应地址，还是发送后被收件方拦截。

内容的提问来源于stack exchange，提问作者JImmy G