如何正确配置iOS应用接入Firebase Local Emulator Suite并规避生产环境

1. 如何初始化FirebaseApp完全避免关联真实生产项目 #

你可以为本地模拟器场景单独构造虚拟的FirebaseOptions参数，完全不使用生产项目的GoogleService-Info.plist配置：

• 只需要保证参数格式合法即可，项目ID、API密钥等字段可以随便填写不存在的内容，一旦模拟器配置失效，SDK尝试访问生产服务时会直接返回项目不存在的错误，绝对不会触达你的真实生产资源。
• 额外增加校验逻辑，本地模拟器模式下必须先完成所有模拟器配置，才允许执行后续Firebase相关操作，可以加断言避免配置逻辑被跳过。

2. 两种Firestore模拟器初始化方式的选择 #

优先使用Firestore.firestore().useEmulator(withHost:port:)方法：

• 手动修改settings的方式是旧版本SDK的兼容方案，官方现在更推荐统一的useEmulator系列方法，会自动处理关闭SSL、适配本地访问路径等细节，不会出现配置项漏改的问题。
• 手动修改settings存在生效限制：如果Firestore实例已经完成初始化（也就是你已经调用过一次Firestore相关接口），再修改settings不会生效，而useEmulator做了内部兼容，只要在第一次调用Firestore接口前执行就可以正常生效。

3. 应用绕过模拟器访问生产的原因 #

你的问题大概率是模拟器配置执行时机过晚导致的：

• 你当前的代码是先执行FirebaseApp.configure()，再判断是否要配置模拟器，但如果有其他代码在configure执行完成后、useEmulator执行前就调用了Auth.auth()或者Firestore.firestore()，SDK会直接初始化生产环境的服务实例，后续再执行模拟器配置也不会对已经初始化的实例生效。
• 你在iOS端使用0.0.0.0作为主机地址也有问题：0.0.0.0是服务端的监听地址，iOS模拟器访问本地电脑的服务应该用localhost或者127.0.0.1，如果是真机测试需要填你电脑的局域网IP地址。
• 另外如果你用到了Functions服务，也要单独调用Functions.functions().useEmulator(withHost:port:)进行配置，否则云函数请求依然会走生产环境。

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