Firebase云函数监听Firestore触发SendGrid发邮件报403错误如何解决

• 核对API Key配置正确性
  运行本地Firebase CLI命令firebase functions:config:get，检查输出的sendgrid.key值和SendGrid后台生成的API Key是否完全匹配，无多余空格、换行符。如果配置错误，执行firebase functions:config:set sendgrid.key="你的实际SendGrid API Key"更新配置后，重新部署Firebase函数。
• 确认API Key权限配置
  进入SendGrid后台的API Keys管理页，查看当前使用的API Key的权限设置，确保Mail Send项为Full Access权限，受限权限的Key会触发403错误。
• 验证收发件人邮箱符合要求
  1. 代码中from字段的值必须和你在SendGrid验证通过的发件人邮箱完全一致，大小写、符号均不能有差异
  2. 若你的SendGrid账号还处于试用阶段，未完成实名认证的话，仅能向已经在SendGrid完成验证的邮箱发送邮件，要么将测试收件人也添加为验证发件人，要么完成SendGrid账号升级解除限制。
• 排查IP限制问题
  本地编写简易测试脚本，使用相同的API Key、收发件人信息尝试发送邮件，如果本地可以发送成功，说明Firebase函数的出口IP被SendGrid临时拦截，更换Firebase函数的部署区域后重新部署即可。
• 优化代码打印完整错误信息
  将原有函数替换为带错误捕获的版本，从日志中获取SendGrid返回的具体错误原因：

  import * as functions from "firebase-functions";
  import * as admin from 'firebase-admin';
  admin.initializeApp();
  import * as sgMail from '@sendgrid/mail';
  
  const API_KEY = functions.config().sendgrid.key;
  sgMail.setApiKey(API_KEY);
  
  exports.newContact = functions.firestore.document('Data/{DataID}')
  .onCreate(async (event) =>{
      const msg = {
          to: 'blankEmail@email.com',
          from: 'blankEmail@email.com',
          subject: 'hello',
          html: 'hey there you why is this function not freaking working'
      }
      try {
          await sgMail.send(msg);
          console.log('邮件发送成功');
      } catch (error) {
          // 打印SendGrid返回的完整错误详情，可直接定位问题
          console.error('错误详情：', error.response?.body || error);
          throw error;
      }
  });
  

  部署后触发函数，在Firebase函数日志中查看打印的错误详情即可得到具体问题，如API Key无效、账户发信额度用尽、发件人未验证等。

内容的提问来源于stack exchange，提问作者Alex Butean