You need to enable JavaScript to run this app. Firebase可调用函数校验data参数时出现undefined及数字键问题
优惠活动
大模型
产品
解决方案
定价
更多

Firebase可调用函数校验data参数时出现undefined及数字键问题

Firebase可调用函数入参异常问题解决方案

根因说明

你遇到的两个异常表现本质原因是前端调用可调用函数时,错误地将user对象序列化为JSON字符串后传入:

  • 后端接收到的data.user实际为字符串类型,不存在displayName等对象属性,因此取值返回undefined
  • 对字符串执行Object.keys()会返回每个字符对应的下标数字数组,和预期的属性名数组不符

修复方案

前端侧修复(推荐优先处理)

Firebase可调用函数本身会自动处理入参的序列化与反序列化,无需手动对参数做JSON.stringify处理。直接将原始user对象作为参数传入即可,示例调用逻辑如下:

// 错误写法
const updateUser = firebase.functions().httpsCallable('updateUser');
updateUser({ user: JSON.stringify(userObj) });

// 正确写法
updateUser({ user: userObj });

后端侧兼容加固

1. 优化类型校验逻辑

原校验逻辑存在漏洞,仅校验传入对象的现有属性都在允许列表中,无法识别缺失必填属性的异常情况,同时缺少对参数类型的前置校验,优化后代码如下:

static instanceOf(object: any): boolean {
    // 前置校验:必须为非空普通对象,排除字符串、数组、null等异常类型
    if (typeof object !== 'object' || object === null || Array.isArray(object)) {
        return false;
    }
    const requiredProperties = ['displayName', 'email', 'phoneNumber', 'photoURL', 'providerId', 'uid', 'lastSignInTime', 'creationTime', 'isEmailVerified'];
    // 校验逻辑改为:所有必填属性都存在于传入对象中
    return requiredProperties.every(prop => prop in object);
}

2. 可调用函数增加兼容逻辑

如果需要兼容前端未修复的场景,可以增加字符串自动解析逻辑,同时拆分校验逻辑返回更明确的错误提示,优化后代码如下:

exports.updateUser = functions.https.onCall((data: { user: User | string }, context) => {
  let user = data.user;
  // 兼容处理:如果传入的是JSON字符串则尝试解析
  if (typeof user === 'string') {
    try {
      user = JSON.parse(user);
    } catch (e) {
      return new ErrorResponse('invalid-argument', 'user参数格式错误').toResponse();
    }
  }

  // 权限校验前置
  if (!context.auth?.uid) {
    return new ErrorResponse('permission-denied', PERMISSION_DENIED_MESSAGE).toResponse();
  }

  // 参数合法性校验
  if (!instanceOf(user)) {
    return new ErrorResponse('invalid-argument', 'user参数缺少必要属性').toResponse();
  }

  // 无需额外做JSON.parse(JSON.stringify)处理,Firebase SDK会自动处理序列化
  db.doc(`${USERS_DB_NAME}/${context.auth.uid}`).set(user);
  return new SuccessResponse<Message>({ message: SUCCESS_MESSAGE }).toResponse();
});

内容的提问来源于stack exchange,提问作者PepeW

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 03:33:02