Firebase Admin SDK云函数无法找到Firestore文档

针对你在Cloud Function中使用Firebase Admin SDK读取Firestore文档失败（提示“No such document!”）的问题，以下是具体排查方向和修正建议：

核心排查点 #

1. 确认Firestore环境与数据一致性 #

• 直接登录Firebase控制台，检查生产环境Firestore中是否存在merchants集合及document1文档。如果前端使用的是本地模拟器数据，而部署后的函数连接生产环境，会出现数据不同步的情况。
• 若本地测试函数，需确保函数连接的Firestore实例（模拟器/生产）与前端数据来源一致。

2. 检查路径拼写与大小写 #

Firestore的集合名、文档ID是大小写敏感的，务必确认代码中的"merchants"和"document1"与控制台中的路径完全一致（包括大小写、特殊字符）。

3. 确认函数关联的Firebase项目 #

如果本地存在多个Firebase项目，通过firebase use命令检查当前函数关联的项目ID，确保与Firestore所在项目完全匹配。

代码优化与修正 #

你的代码存在导入冗余、混合await与.then()的问题，以下是简化且更易维护的版本：

const {onRequest} = require("firebase-functions/v2/https");
const logger = require("firebase-functions/logger");
const admin = require('firebase-admin');

// 统一初始化Admin SDK
admin.initializeApp();
const db = admin.firestore();

exports.helloWorld = onRequest(async (request, response) => {
  logger.info("Hello logs!", {structuredData: true});
  
  try {
    const docSnap = await db.collection("merchants").doc("document1").get();
    
    if (!docSnap.exists) {
      logger.warn('目标文档不存在: merchants/document1');
      return response.status(404).send('Not Found');
    }
    
    logger.info('成功获取文档数据:', docSnap.data());
    response.json(docSnap.data());
  } catch (err) {
    logger.error('读取文档失败:', err);
    response.status(500).send('Internal Server Error');
  }
});

代码优化说明 #

• 统一使用async/await替代then/catch，提升代码可读性
• 用官方logger替代console.log，便于在Firebase控制台查看结构化日志
• 增加HTTP状态码返回，符合REST接口规范

验证步骤 #

1. 部署优化后的函数，通过Firebase控制台的Cloud Functions页面触发测试
2. 查看函数日志，若仍提示文档不存在，再次核对控制台中的Firestore数据路径
3. 确认函数服务账号拥有Firestore读取权限（默认Admin SDK初始化已包含全权限，无需额外配置）

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