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
相关产品推荐
相关产品推荐

