部署到iPhone的Ionic 5应用Firestore无法连接问题求助

问题排查与解决步骤 #

• 检查iOS应用传输安全(ATS)配置
  Cordova iOS 6+默认启用ATS限制，需在Xcode打开项目后，找到Info.plist文件添加如下配置，放开HTTPS请求限制（也可单独添加Firebase相关域名到白名单，更安全）：

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

• 核对白名单插件配置
  你已安装cordova-plugin-whitelist，需确认项目根目录的config.xml中存在以下配置，允许应用访问外部网络：

  <allow-navigation href="*" />
  <allow-intent href="*" />
  <access origin="*" />
  

  生产环境上线前可将通配符替换为Firebase相关域名，缩小权限范围。
• 确认iOS端Firebase配置文件位置正确
  热重载调试时会调用Web端Firebase配置，原生打包部署时需要读取iOS专属配置文件：将从Firebase控制台下载的GoogleService-Info.plist文件放入platforms/ios/[你的应用名]/目录下，且确保文件中的Bundle ID与Xcode中配置的应用Bundle ID完全一致。
• 检查生产环境构建配置
  确认src/environments/environment.prod.ts中的Firebase配置与开发环境一致，没有填写错误；也可临时关闭angular.json中生产构建的摇树优化配置，排查是否是打包时裁剪了必要的Firebase依赖模块导致初始化失败。
• 获取明确报错日志
  可通过两种方式获取原生打包后的运行日志：
  1. 将iPhone连接到Mac，打开Xcode通过「Window > Devices and Simulators」选择对应设备，查看实时运行日志
  2. 打开iPhone设置中的「Safari浏览器 > 高级 > Web检查器」，Mac端打开Safari的「开发」菜单，选择对应设备的应用WebView，查看控制台报错信息
• 额外建议：执行构建前先删除根目录下的platforms、plugins文件夹，重新运行ionic cordova platform add ios，避免旧缓存的配置残留影响构建结果。

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