Firestore如何使用模拟器测试导出到Storage的功能

问题核心原因说明 #

你遇到的权限报错不是因为需要真实服务账号权限，本质是FirestoreAdminClient属于Firestore的管理类API客户端，不会自动读取FIRESTORE_EMULATOR_HOST环境变量走模拟器适配逻辑，仍然按照线上环境的规则做凭证校验。常规文档读写的客户端会自动适配模拟器，所以你之前的认知是对的，本地模拟器默认不需要任何真实凭证、会关闭所有权限校验。

推荐解决方案（和官方文档对齐，使用firebase-admin包） #

官方推荐用firebase-admin连接模拟器的原因是它会自动适配所有Firebase服务的模拟器逻辑，包括管理类API的凭证绕过，修改后的测试脚本如下：

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

// 环境变量配置必须放在admin初始化之前
process.env.FIRESTORE_EMULATOR_HOST = 'localhost:8080';
// 导出需要用到Storage存储备份文件，同步配置Storage模拟器
process.env.FIREBASE_STORAGE_EMULATOR_HOST = 'localhost:9199';

// 初始化不需要传真实服务账号，模拟器环境会自动生成虚拟凭证
admin.initializeApp({
  projectId: 'test-develop' // 和你启动模拟器时用的项目ID完全一致即可
});

async function exportAllDocuments() {
  const client = new admin.firestore.v1.FirestoreAdminClient();
  const projectId = 'test-develop';
  const databaseName = client.databasePath(projectId, '(default)');
  
  const [response] = await client.exportDocuments({
    name: databaseName,
    // 导出路径必须加gs://前缀，后面跟你模拟器中的存储桶名称
    outputUriPrefix: "gs://test-bucket",
    collectionIds: ['test-backup']
  });
  console.log(`Operation Name: ${response.name}`);
}

exportAllDocuments().catch(err => {
  console.error('导出失败：', err);
  process.exit(1);
});

启动测试前需要先确保Firebase模拟器套装同时开启了Firestore和Storage两个模拟器，否则会因为缺少存储目的地报错。

如果你坚持使用@google-cloud/firestore独立客户端的适配方法 #

需要手动给FirestoreAdminClient配置模拟器的服务地址和虚拟凭证，禁用线上SSL校验：

const firestore = require('@google-cloud/firestore');
const grpc = require('@grpc/grpc-js');
const { GoogleAuth } = require('google-auth-library');

// 构造虚拟凭证，格式正确即可，模拟器不会校验内容有效性
const virtualAuth = new GoogleAuth({
  credentials: {
    client_email: 'fake-admin@test-develop.iam.gserviceaccount.com',
    private_key: '-----BEGIN PRIVATE KEY-----\nMIIEowIBAAKCAQEAx+zY2kF\n-----END PRIVATE KEY-----\n'
  },
  projectId: 'test-develop'
});

// 手动指定模拟器连接参数
const client = new firestore.v1.FirestoreAdminClient({
  servicePath: 'localhost',
  port: 8080,
  sslCreds: grpc.credentials.createInsecure(),
  auth: virtualAuth
});

// 后续导出逻辑和之前一致，注意outputUriPrefix要加gs://前缀

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