Node.js集成Firebase创建用户时添加用户文档报错求助

问题情况 #

仅创建Firebase认证用户时功能正常，但添加代码在users集合中创建用户文档后出现错误，相关代码如下：

router.post('/signup',async (req, res, next)=>{
//probably in the request there will be some data
//create user in the system
console.log('INSIDE SIGN UP');
const userResponse = await database.auth().createUser({
    email: req.body.email,
    password: req.body.password,
    emailVerified: false,
    disabled: false
})
res.json(userResponse);

//create user in the table with extra properties
const userDoc = {
    firebaseId: userResponse.uid,
    username: '',
    profilePic: ''
}
db.collection('users').add(userDoc).then(result => {
    console.log(result);
}).catch(err => {
    console.log('opps there was an error');
    console.log(err);
});
});

问题分析与解决方案 #

1. 异步流程与响应顺序问题 #

原代码中res.json(userResponse)在创建文档前执行，导致后续创建文档的错误无法反馈给前端，且响应发送后后续逻辑异常难以追踪。同时回调嵌套的异步写法不利于错误统一捕获。

2. 修正后的代码 #

改用async/await统一处理异步操作，将所有逻辑包裹在try/catch中，确保错误能被捕获并返回给前端：

router.post('/signup', async (req, res, next) => {
  try {
    console.log('INSIDE SIGN UP');
    // 创建Firebase认证用户
    const userResponse = await database.auth().createUser({
      email: req.body.email,
      password: req.body.password,
      emailVerified: false,
      disabled: false
    });

    // 创建users集合文档
    const userDoc = {
      firebaseId: userResponse.uid,
      username: '',
      profilePic: ''
    };
    const docResult = await db.collection('users').add(userDoc);
    console.log('用户文档创建成功:', docResult);

    // 所有操作完成后返回响应
    res.json({ 
      authUser: userResponse,
      userDocId: docResult.id 
    });
  } catch (err) {
    console.error('注册过程出错:', err);
    // 向前端返回错误状态码与信息
    res.status(500).json({ error: err.message });
  }
});

3. 其他排查方向 #

• Firestore实例初始化检查：确保db是通过Firebase Admin SDK正确初始化的实例，示例如下：

  const admin = require('firebase-admin');
  const serviceAccount = require('./serviceAccountKey.json'); // 替换为你的密钥路径
  
  admin.initializeApp({
    credential: admin.credential.cert(serviceAccount)
  });
  
  const db = admin.firestore();
  const database = admin.auth();
  

• Firestore安全规则检查：若使用Admin SDK，服务器端操作不受默认规则限制；若为客户端SDK，需调整规则允许写入（测试阶段可临时设置allow read, write: if true;，正式环境需严格限制权限）。
• 错误日志分析：根据报错信息针对性处理，比如权限不足则调整规则，实例未定义则检查初始化代码。

内容的提问来源于stack exchange，提问作者Pedro Henrique Ferreira