如何从.NET应用/集成测试访问Firebase模拟器？

第一步：确认Docker端口映射配置 #

启动Firebase模拟器容器时，必须将各个服务的端口映射到宿主机，否则外部无法访问。执行类似以下的启动命令：

docker run -p 4000:4000 -p 8080:8080 -p 9099:9099 -p 8085:8085 -p 5001:5001 [你的Firebase模拟器镜像名称]

确保所有需要的端口（Firestore:8080、Auth:9099、PubSub:8085、Functions:5001）都完成映射。

第二步：正确初始化Firebase Admin SDK #

Firebase模拟器不需要真实的Google服务账号凭据，使用空令牌或匿名凭据即可绕过身份验证，同时确保环境变量在初始化前设置完成：

// 必须在FirebaseApp.Create()之前设置环境变量
Environment.SetEnvironmentVariable("FIRESTORE_EMULATOR_HOST", "127.0.0.1:8080");
Environment.SetEnvironmentVariable("FIREBASE_AUTH_EMULATOR_HOST", "127.0.0.1:9099");
Environment.SetEnvironmentVariable("PUBSUB_EMULATOR_HOST", "127.0.0.1:8085");
Environment.SetEnvironmentVariable("FUNCTIONS_EMULATOR_HOST", "127.0.0.1:5001");
Environment.SetEnvironmentVariable("GCLOUD_PROJECT", "test-project");

// 使用空令牌初始化，模拟器会接受该凭据
var appOptions = new AppOptions
{
    Credential = GoogleCredential.FromAccessToken(""),
    ProjectId = "test-project"
};

var firebaseApp = FirebaseApp.Create(appOptions);

也可以使用匿名凭据替代空令牌，效果一致：

Credential = GoogleCredential.Anonymous()

第三步：排查特殊环境问题 #

• WSL2环境：如果Docker运行在WSL2中，127.0.0.1无法直接映射到Windows宿主机，需要替换为WSL的局域网IP（可通过hostname -I命令查询），例如：

  Environment.SetEnvironmentVariable("FIRESTORE_EMULATOR_HOST", "172.17.0.2:8080");
  

• 集成测试场景：确保环境变量在测试初始化阶段（如xUnit的构造函数、NUnit的[SetUp]方法）就完成设置，避免FirebaseApp初始化后才读取变量。

验证配置有效性 #

初始化前可以打印环境变量确认是否生效：

Console.WriteLine($"Firestore Emulator Host: {Environment.GetEnvironmentVariable("FIRESTORE_EMULATOR_HOST")}");

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