Firebase Cloud Functions返回内部错误排查求助

核心问题定位 #

你遇到的内部错误根源是客户端传参方式错误：Firebase Cloud Functions的httpsCallable的call方法会自动处理参数的序列化/反序列化，不需要手动调用jsonEncode。当前传入JSON字符串会导致云函数中data是字符串而非对象，无法读取Email字段，最终触发未正确处理的错误。

修复步骤 #

1. 修正客户端Flutter代码 #

移除手动JSON编码，直接传入Map：

Future<bool> forgotPassword(String email) async {
    final functions = FirebaseFunctions.instanceFor(region: "australia-southeast1");
    Map<String, dynamic> data = {
        "Email": email,
    };

    try {
      // 直接传入Map，无需jsonEncode
      await functions.httpsCallable("resetPasswordNew").call(data);
      return true;
    } on FirebaseFunctionsException catch (e) {
      print(e.message);
      return false;
    }
}

2. 云函数代码优化（可选但推荐） #

• 增加参数校验，避免因字段缺失导致的错误：

exports.resetPasswordNew = functions.https.onCall(async (data) => {
  // 新增参数校验
  if (!data.Email || typeof data.Email !== 'string') {
    throw new HttpsError('invalid-argument', 'Email字段缺失或格式错误');
  }

  const userData = data;
  const dest = userData["Email"];
  const subject = `Password Reset Email`;
  
  // ... 其余代码不变
});

• 将回调式的fs.readFile改为Promise版本，确保异步操作规范执行：

// 替换原fs.readFile部分
try {
  const template = await fs.promises.readFile('./invitation.html', 'utf8');
  
  const invitationData = {
    "%Name%": userData["FirstName"] || "",
    "%Username%": userData["Email"],
    "%Password%": tempPassword,
    "%Institute Name%": userData["institutionName"] || "",
  };

  Object.keys(invitationData).forEach(key => {
    template = template.replace(key, invitationData[key]);
  });

  // 若emailHelper.sendEmail不支持Promise，可自行包装为Promise
  await emailHelper.sendEmail(dest, subject, template);
  logger.log(`Welcome Email sent to ${dest}`);
} catch (err) {
  logger.error(err);
  logger.error(`Error sending Email to ${dest}`);
}

额外排查建议 #

• 查看云函数详细日志（Firebase控制台 > Cloud Functions > 日志），错误栈信息比Metrics更直观，能精准定位问题。
• 确认云函数部署的函数名resetPasswordNew与客户端调用的完全一致，无大小写或拼写错误。

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