Firestore中第二个DocumentSnapshot.data()返回undefined问题求助

我在Firebase Cloud Functions里写了一段代码，获取两个Firestore文档快照：第一个从user-secrets集合拿数据完全正常，能读到emailNonce；但第二个从box-secrets集合取的快照，明明日志里能看到这个快照对象，调用.data()却返回undefined。

代码片段 #

const addRentalFct = async (data, context) => {

    // 这段正常工作:
    const secretsRef = db.collection('user-secrets').doc('Yv3gZU8TeJTixl0njm7kUXXpvhc2');
    const secretsSnap = await secretsRef.get();
    const dbNonce = secretsSnap.data().emailNonce;
    functions.logger.log('got the dbNonce: ', dbNonce);

    // 这段不工作，但逻辑和上面一致:
    const boxesSecretsRef = db.collection('box-secrets').doc('CB8lNQ8ZUnv4FDT6ZXGW');
    const boxSecretsSnap = await boxesSecretsRef.get();
    functions.logger.log('got the boxSecretsSnap: ', boxSecretsSnap);
    functions.logger.log('got the boxSecretsSnap.data(): ', boxSecretsSnap.data());
    const boxPassword = boxSecretsSnap.data().password;
    functions.logger.log('the box secret is: ', boxPassword);

...
}

日志和数据库情况 #

• 日志显示boxSecretsSnap对象存在，但boxSecretsSnap.data()输出为undefined
• box-secrets集合里确实有ID为CB8lNQ8ZUnv4FDT6ZXGW的文档，且包含password字段
• user-secrets集合的文档读取正常

排查方向和解决办法 #

1. 先确认文档是否真的存在
   在代码里加个存在性检查，避免因为环境不一致（比如函数连的是生产库，你看的是开发库）导致的问题：

   if (!boxSecretsSnap.exists) {
       functions.logger.error('目标文档不存在');
       return;
   }
   

2. 检查Firestore安全规则
   Cloud Functions用的服务账号可能没有box-secrets集合的读取权限。临时修改规则测试：

   match /box-secrets/{docId} {
     allow read: if true; // 测试用，生产环境一定要改成严格权限
   }
   

   测试通过后，再根据业务需求配置合适的权限（比如只允许函数的服务账号读取）。

3. 核对文档ID的拼写
   仔细检查代码里的文档IDCB8lNQ8ZUnv4FDT6ZXGW和数据库里的是否完全一致——尤其注意容易混淆的字符，比如小写L（l）和数字1，大写O和数字0。

4. 确认数据库实例初始化正确
   检查db对象是否正确指向了你的开发环境Firestore，有没有误连到其他环境的数据库。

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