Firebase模拟器配置疑问：Cloud Functions如何配置凭证连接Firestore模拟器？

核心问题分析 #

本地运行Cloud Functions时，直接调用admin.initializeApp()会尝试读取真实的服务账号凭证，导致两个问题：一是找不到凭证文件抛出ENOENT错误，二是会连接真实Firestore实例而非模拟器。模拟器环境下不需要真实凭证，Firebase CLI会提供测试认证，只需正确指定模拟器地址即可。

解决方案步骤 #

1. 修改Admin SDK初始化代码 #

通过环境变量判断是否处于模拟器环境，强制Firestore连接到本地模拟器：

const admin = require('firebase-admin');

// 初始化Admin SDK（无需传入真实凭证）
admin.initializeApp();

const db = admin.firestore();

// 本地模拟器环境下切换到Firestore模拟器
if (process.env.FUNCTIONS_EMULATOR === 'true') {
  db.settings({
    host: 'localhost:8080', // Firestore模拟器默认端口，若自定义端口需对应修改
    ssl: false // 模拟器无需SSL加密
  });
}

2. 取消本地环境的真实凭证配置 #

• 不要设置GOOGLE_APPLICATION_CREDENTIALS环境变量，模拟器运行时Firebase CLI会自动注入测试认证信息。
• 若之前已设置该环境变量，本地运行前临时取消（终端执行unset GOOGLE_APPLICATION_CREDENTIALS，Windows系统执行set GOOGLE_APPLICATION_CREDENTIALS=）。

3. 确认模拟器配置与启动 #

• 检查firebase.json中的模拟器端口配置是否正确（默认端口如下，可自定义）：

{
  "emulators": {
    "firestore": {
      "port": 8080
    },
    "functions": {
      "port": 5001
    }
  }
}

• 启动模拟器时确保包含Firestore和Functions：

firebase emulators:start --only firestore,functions

关键说明 #

• process.env.FUNCTIONS_EMULATOR是Firebase模拟器自动设置的环境变量，值为true时表示当前在本地模拟器环境运行。
• 模拟器环境下Admin SDK使用内置测试凭证，不会访问云端真实Firebase服务，无需担心数据安全问题。

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