Ionic/Capacitor应用升级Angular/Fire V7与Firebase V9后iOS无法运行求助

排查方向 #

• 首先验证IndexedDB持久化逻辑的兼容性问题
  你当前代码中开启了enableIndexedDbPersistence，而iOS WKWebView在生产包模式下的存储沙盒规则和热重载（ionic cap run ios -l）模式完全不同，iOS 14/15对生产包内IndexedDB的配额、初始化权限有特殊限制，且如果持久化初始化失败会被静默吞掉不会抛出上层错误。你可以先注释掉enableIndexedDbPersistence相关代码，打生产包测试Firestore是否能正常返回数据，如果恢复正常就可以定位是持久化逻辑的问题，后续可以替换为Capacitor原生存储方案适配iOS。

• 检查生产构建摇树优化的误删问题
  ionic cap sync --prod会启用Angular全量构建优化，Firebase 9的模块化API很容易被buildOptimizer误摇掉必要的依赖模块。可以先修改angular.json中生产构建的配置，临时把buildOptimizer、optimization设为false，打测试包验证功能是否恢复，如果恢复正常，就在polyfills.ts中添加一行import '@firebase/firestore'强制引入全量Firestore模块，避免被摇树删除。

• 验证iOS ATS安全策略是否拦截请求
  生产包默认开启App Transport Security（ATS）规则，热重载模式因为连接的是外部HTTP服务，会自动放宽ATS限制。你可以在iOS项目的Info.plist中添加如下配置临时关闭ATS验证，测试是否是安全策略拦截了Firestore请求：

<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
</dict>

• 排查生产环境Firebase配置正确性
  确认environment.prod.ts中的Firebase配置参数和开发环境完全一致，没有拼写错误。你可以在Firestore初始化代码中添加错误捕获逻辑，把日志输出到Xcode控制台排查：

provideFirestore(() => {
  const firestore = getFirestore();
  enableIndexedDbPersistence(firestore)
    .catch(err => console.log('Firestore持久化初始化失败', err));
  return firestore;
}),

• 检查第三方插件的网络拦截冲突
  如果你使用了任何原生网络相关的Capacitor/Cordova插件（比如全局网络拦截、自定义HTTP客户端类插件），这类插件在iOS和安卓的实现逻辑差异很大，可能会拦截Firestore的底层请求。可以先卸载所有网络相关的第三方插件，打生产包测试是否恢复正常。

• 验证Xcode构建配置兼容性
  确认Xcode项目中的iOS Deployment Target设置不低于12.0，符合Firebase 9和Capacitor 3的最低支持版本要求，同时确认构建架构包含了你测试设备的对应架构。

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