修改ATS设置致React Native iOS应用异常：Metro编译成功但无法启动

我正在开发一款iOS端React Native应用，由于后端API尚未配置SSL，需要为ATS添加例外规则。修改info.plist之前，应用能正常加载，但所有API请求均被拦截无法工作；按照以下代码编辑info.plist添加域名例外后，Metro编译成功，但模拟器中应用直接白屏，完全无法正常运行。

修改前状态 #

修改前应用可正常加载：

添加的ATS配置代码 #

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSExceptionDomains</key>
    <dict>
        <key>mysite.com</key>
        <dict>
            <!--Include to allow subdomains-->
            <key>NSIncludesSubdomains</key>
            <true/>
            <!--Include to allow HTTP requests-->
            <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
            <true/>
            <!--Include to specify minimum TLS version-->
            <key>NSTemporaryExceptionMinimumTLSVersion</key>
            <string>TLSv1.1</string>
        </dict>
    </dict>
</dict>

修改后状态 #

修改后应用白屏无法加载：

不清楚问题所在，求可行的解决思路？

排查解决思路 #

• 检查info.plist格式合法性：手动编辑info.plist很容易出现语法错误，比如标签未闭合、多余空格/换行导致的格式混乱。建议用Xcode打开该文件（右键选择"Open As" -> "Property List"），确认所有键值对都正常显示，没有红色报错提示。
• 清理全链路缓存后重新构建：React Native的缓存经常会引发奇怪的兼容性问题，执行以下命令清理后再重新运行：

  # 重置Metro缓存
  npx react-native start --reset-cache
  # 清理iOS依赖缓存并重装
  cd ios && pod deintegrate && pod install && cd ..
  # 重新运行iOS应用
  npx react-native run-ios
  

• 验证域名配置准确性：确认mysite.com是你实际请求的API根域名，不要带http://或https://前缀。如果API是子域名（比如api.mysite.com），要么确保NSIncludesSubdomains已设为true，要么直接将子域名作为例外域名配置。
• 查看Xcode控制台错误日志：打开Xcode中的项目，运行应用后查看底部控制台输出，白屏通常会伴随具体的错误信息（比如ATS配置不合法、启动时网络请求失败导致JS崩溃等），这是定位问题最直接的方式。
• 临时全局禁用ATS测试：可以先尝试全局禁用ATS（仅用于测试，上线前务必改回），验证是否能解决白屏问题，以此判断是否是域名例外配置的问题。全局禁用配置如下：

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

  如果全局禁用后应用正常加载，说明之前的域名例外配置存在细节错误，比如域名拼写错误、键名大小写错误（iOS的plist键名区分大小写）。
• 检查启动阶段的JS请求逻辑：修改ATS配置后，是否有应用启动时同步执行的网络请求？如果请求失败未被捕获，可能会导致JS线程崩溃，进而引发白屏。可以暂时注释掉启动时的API请求，看应用是否能正常加载，再逐步排查请求逻辑。

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