调用RESTful Web服务遇System.TypeLoadException错误求助（含iOS场景）

我之前在iOS设备上调用REST服务时也碰到过一模一样的问题，就是执行await client.GetAsync(RestUrl)时触发System.TypeLoadException，折腾了好一阵才搞定。结合我的经验，给你几个排查方向和具体的解决办法：

1. 先排查.NET版本和依赖库的兼容性问题 #

iOS平台对.NET API的支持和桌面端差异不小，尤其是System.Net.Http这块的实现。如果你的项目用的是旧版本的.NET或者第三方HttpClient库，很容易出类型加载失败的问题。

• 先确认项目用的是兼容iOS的.NET版本：比如.NET 6及以上，要是用Xamarin.iOS的话，也得对应到较新的稳定版。
• 试试切换HttpClient的底层实现：iOS上推荐用NSUrlSession来处理网络请求，你可以配置HttpClientHandler来切换，要是MAUI项目的话直接用Microsoft.Maui.Networking.HttpClient会更适配。
• 清理NuGet缓存：有时候依赖包缓存乱了也会出问题，跑个dotnet clean再dotnet restore，说不定就好了。

2. 检查链接器是不是把必要类型删了 #

iOS构建时默认会开链接器来减包体积，这玩意儿有时候会误删HttpClient相关的必要类型，导致运行时找不到。

• 先临时把链接器设置改成**"Don't link"**测试下：如果改了之后不报错，那就是链接器的锅。
• 给链接器加保留规则：在项目里新建个Linker.xml文件，把需要保留的类型加进去，比如：

  <linker>
    <assembly fullname="System.Net.Http">
      <type fullname="System.Net.Http.HttpClient" preserve="all"/>
      <type fullname="System.Net.Http.HttpResponseMessage" preserve="all"/>
    </assembly>
  </linker>
  

• 另外，要是你代码里有用反射加载HttpClient相关类型的话，也得给反射用到的类型加保留规则，不然链接器照样会删。

3. 看看iOS的网络配置有没有问题 #

iOS上的ATS（App Transport Security）和权限配置，有时候会间接引发这种类型加载异常——看起来是类型的问题，其实是底层网络请求失败连锁反应出来的。

• 要是你的REST服务是HTTP不是HTTPS，得在Info.plist里加ATS例外：

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

  注意：苹果现在更推荐用HTTPS，这个配置提交App Store的时候可能需要说明原因。
• 别忘了加网络权限描述：在Info.plist里加这个，不然iOS会阻止网络请求：

  <key>NSNetworkUsageDescription</key>
  <string>需要访问网络获取服务数据</string>
  

4. 异步调用的上下文也可能出问题 #

iOS上的UI线程同步上下文有时候会搞事情，要是你在UI线程直接调用await，没处理好的话也可能引发异常。

• 试试在调用GetAsync的时候加ConfigureAwait(false)：

  HttpResponseMessage response = await client.GetAsync(RestUrl).ConfigureAwait(false);
  

  这样可以避免UI线程死锁，也能减少上下文切换带来的问题。
• 另外，HttpClient最好做成单例，别频繁创建销毁，不然不仅性能差，也容易引发各种奇怪的异常。

最后给个调试小技巧 #

• 打开详细日志：在iOS项目里启用日志输出，看TypeLoadException的完整堆栈，找到具体是哪个类型加载失败，一下子就能定位问题。
• 用Xcode看设备日志：把iPad连到Xcode，看控制台的底层日志，有时候会有更详细的错误信息，比.NET的日志更有用。

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