Ionic5 Capacitor执行ionic cap build ios后iOS模拟器调用API报错如何解决

该问题90%以上的场景是iOS端安全限制、环境配置或跨域规则不匹配导致的，按以下优先级排查修复：

1. 检查iOS App Transport Security(ATS)配置 #

iOS默认禁止所有非HTTPS、以及使用低版本TLS协议的请求，live reload模式下会自动生成临时豁免规则，正式构建后规则失效导致请求被拦截。
修复方式：
打开iOS项目下的ios/App/App/Info.plist文件，添加以下配置：

<key>NSAppTransportSecurity</key>
<dict>
  <!-- 开发测试用：允许所有HTTP请求，生产环境建议移除，改为指定域名豁免 -->
  <key>NSAllowsArbitraryLoads</key>
  <true/>
  <!-- 生产环境配置示例，替换为你的API域名
  <key>NSExceptionDomains</key>
  <dict>
    <key>your-api-domain.com</key>
    <dict>
      <key>NSExceptionAllowsInsecureHTTPLoads</key>
      <true/>
      <key>NSIncludesSubdomains</key>
      <true/>
    </dict>
  </dict>
  -->
</dict>

修改后重新构建iOS应用测试。

2. 核对构建环境的API地址配置 #

多数情况是开发/生产环境变量切换时出错：

• live reload模式下你使用了--external参数，API地址一般配置为电脑局域网IP，可正常访问后端
• 正式构建时如果忘记替换环境变量，仍使用localhost/127.0.0.1作为API地址，iOS模拟器会将其指向模拟器自身而非你的电脑后端，导致请求失败
  修复方式：检查你项目中生产环境配置文件（比如Angular的environment.prod.ts、React的.env.production）中的API地址，测试阶段改为你电脑的局域网IP，生产阶段改为线上服务器域名。

3. 后端CORS规则补全Capacitor WebView的Origin #

live reload模式下请求的Origin是http://<你的局域网IP>:<端口>，后端已经配置了允许；但正式构建后Capacitor WebView的默认Origin是capacitor://localhost，如果后端CORS规则没有放行这个Origin，预检请求会直接被拦截，返回0未知错误。
修复方式：在你的.NET Core后端CORS配置中，添加capacitor://localhost到允许的Origin列表。

4. 配置Capacitor允许访问API域名 #

打开项目根目录的capacitor.config.ts/capacitor.config.json，添加allowNavigation配置，放行你的API域名，避免WebView拦截跨域请求：

// capacitor.config.ts 示例
const config: CapacitorConfig = {
  // 其他配置
  server: {
    allowNavigation: ["your-api-domain.com", "*.your-api-domain.com"]
  }
}

5. 可选：替换为Capacitor原生HTTP插件 #

如果以上方案都无效，可以将前端的Http请求库（比如Angular HttpClient、Axios）替换为@capacitor/http原生插件，原生发起的请求不受WebView的CORS、ATS部分规则限制，兼容性更好。

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