Firebase Firestore传参更新文档字段时出现嵌套对象异常问题

根据你描述的最终存储结构firstName: {firstName: newFirstName}倒推，出现这类嵌套写入异常的触发点主要包含三类：

• 入参结构不匹配：调用函数时传入的newFirstName本身就是{firstName: "实际姓名"}结构的对象，而非纯字符串值。按照当前代码的赋值逻辑"firstName" : newFirstName，最终写入的结果会和你遇到的异常完全吻合。
• 异步逻辑漏洞：代码中对update的调用没有添加await关键字，函数也没有返回SDK的Promise执行结果，遇到SDK自动重试、外层传参时序错乱的情况时，很容易出现参数结构错配，最终写入嵌套对象。
• 封装逻辑篡改：项目中对usersRef做二次封装时，如果在update方法内部额外给传入参数套了一层对应字段的包装结构，会直接把你传入的平面对象转成嵌套结构写入数据库。

• 第一时间在update操作前加入参校验，打印typeof newFirstName和实际值，确认传入值是纯字符串，避免带业务结构的对象直接入库。
• 补全异步逻辑和入参拦截，修正后的可运行代码参考：

export async function dbUpdateFirstName(uid, newFirstName){
  try{
    // 提前拦截异常入参，避免脏数据写入
    if (typeof newFirstName !== 'string' || !newFirstName.trim()) {
      throw new Error('firstName必须为非空字符串')
    }
    // 等待SDK操作完成，返回执行结果
    return await usersRef.doc(uid).update({
      firstName : newFirstName
    })
  } catch(err){
    console.log(err)
    return err
  }
}

• 如果排查确认入参没有问题，就顺着usersRef的初始化流程，检查二次封装的update方法有没有额外做参数包装，确认Firestore SDK的原生逻辑没有被篡改。

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