Firebase Cloud Functions更新后SendGrid事务邮件功能失效，求修改方案

看起来是Firebase Functions从beta版本升级到v1正式版导致的代码兼容性问题，主要是初始化方式和触发器参数的变化，下面是具体的修改方案：

核心修改点 #

1. 调整Admin SDK初始化方式 #

旧版本的初始化代码需要传入functions.config().firebase，但v1版本之后，Firebase会自动为Cloud Functions注入默认配置，所以直接修改为：

// 替换原来的 admin.initializeApp(functions.config().firebase);
admin.initializeApp();

2. 适配Firestore触发器参数（如果你的函数用了Firestore触发器） #

beta版本中Firestore触发器的参数是event，v1版本拆分成了文档快照（snap）和上下文对象（context）：

• 原来的event.data → 现在用snap（比如onCreate触发器的snap就是新增的文档快照）
• 获取文档数据用snap.data()，替代旧的event.data.data()
• 获取路径中的动态参数（比如orders/{orderId}里的orderId）用context.params.orderId，替代旧的event.params.orderId

3. 确保依赖包更新 #

先把firebase-functions和firebase-admin升级到最新版本，避免版本兼容问题：

npm install firebase-functions@latest firebase-admin@latest --save

修改后的完整示例代码 #

假设你的函数是监听Firestore订单创建事件来发送邮件，修改后的代码如下：

const functions = require('firebase-functions');
const admin = require('firebase-admin');
const sgMail = require('@sendgrid/mail');

// 新版本初始化方式
admin.initializeApp();

// 配置SendGrid API密钥（确保已经通过firebase functions:config:set设置过）
sgMail.setApiKey(functions.config().sendgrid.api_key);

// v1版本的Firestore onCreate触发器
exports.sendOrderConfirmation = functions.firestore
  .document('orders/{orderId}')
  .onCreate(async (snap, context) => {
    // 获取订单数据
    const order = snap.data();
    const customerEmail = order.customerEmail;
    const orderId = context.params.orderId;

    // 构造邮件内容
    const emailContent = {
      to: customerEmail,
      from: 'your-support@example.com', // 要在SendGrid中验证发件邮箱
      subject: `订单确认：#${orderId}`,
      html: `
        <h3>感谢你的下单！</h3>
        <p>你的订单ID：${orderId}</p>
        <p>订单详情：${JSON.stringify(order)}</p>
      `
    };

    try {
      // 发送邮件
      await sgMail.send(emailContent);
      console.log(`邮件已发送给：${customerEmail}`);
      return null;
    } catch (error) {
      console.error('发送邮件失败：', error);
      // 打印SendGrid的详细错误信息
      if (error.response) {
        console.error('SendGrid错误响应：', error.response.body);
      }
      return null;
    }
  });

最后部署验证 #

修改完成后，重新部署你的函数：

firebase deploy --only functions

这样应该就能恢复SendGrid邮件发送功能了，如果还有问题，可以查看Cloud Functions的日志，里面会有更详细的错误信息帮助排查。

内容的提问来源于stack exchange，提问作者Paco Zevallos