.NET MAUI中使用ServiceStack客户端发起API请求时iOS发布模式崩溃

先拿到崩溃日志再说 #

没有具体错误信息根本没法精准定位问题，先通过以下方式获取崩溃日志：

• 用Xcode连接iOS设备，打开「Devices and Simulators」→ 选中你的设备 → 点击「View Device Logs」，找到对应应用的崩溃记录，查看其中的Exception Type和调用栈信息。
• 或者在App中添加全局异常捕获，把错误写入本地文件：

// 在App.xaml.cs的OnStart方法中添加
AppDomain.CurrentDomain.UnhandledException += (sender, e) =>
{
    var ex = e.ExceptionObject as Exception;
    var logPath = Path.Combine(FileSystem.AppDataDirectory, "crash.log");
    File.WriteAllText(logPath, ex?.ToString() ?? "未知崩溃");
};

TaskScheduler.UnobservedTaskException += (sender, e) =>
{
    var logPath = Path.Combine(FileSystem.AppDataDirectory, "crash.log");
    File.WriteAllText(logPath, e.Exception.ToString());
    e.SetObserved();
};

发布包安装到设备后，导出这个crash.log文件就能看到具体错误细节。

常见崩溃原因及解决办法 #

1. AOT编译不兼容 #

iOS发布模式强制启用AOT编译，ServiceStack中的部分动态反射特性会失效，给项目添加AOT兼容配置：
打开项目的.csproj文件，添加以下配置：

<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)'=='Release|net7.0-ios'">
  <AotAdditionalArguments>--interpret</AotAdditionalArguments>
  <EnableAotAnalyzer>false</EnableAotAnalyzer>
</PropertyGroup>

或者直接让链接器保留ServiceStack的所有代码：

<ItemGroup Condition="'$(Configuration)|$(TargetFramework)'=='Release|net7.0-ios'">
  <TrimmerRootAssembly Include="ServiceStack" />
  <TrimmerRootAssembly Include="ServiceStack.Client" />
  <TrimmerRootAssembly Include="ServiceStack.HttpClient" />
</ItemGroup>

2. 链接器删除了关键代码 #

iOS发布模式默认开启链接器优化，可能会误删ServiceStack的必要代码：

• 打开项目属性→iOS Build，将「Linker Behavior」修改为「Link Framework SDKs Only」。
• 或者新建linker.xml文件，内容如下：

<linker>
  <assembly fullname="ServiceStack">
    <type fullname="*" />
  </assembly>
  <assembly fullname="ServiceStack.Client">
    <type fullname="*" />
  </assembly>
  <assembly fullname="ServiceStack.HttpClient">
    <type fullname="*" />
  </assembly>
</linker>

然后在.csproj中引用这个文件：

<ItemGroup>
  <LinkerDescriptor Include="linker.xml" />
</ItemGroup>

3. 网络权限未配置 #

iOS发布模式下必须明确声明网络权限，打开Info.plist添加以下配置：

<!-- 允许任意网络请求（HTTP请求必须添加；HTTPS可配置更严格的规则） -->
<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
</dict>
<!-- 网络权限描述，必填否则无法通过审核 -->
<key>NSLocalNetworkUsageDescription</key>
<string>需要访问网络以获取数据</string>

4. ServiceStack客户端配置问题 #

检查客户端初始化代码，发布模式下避免启用调试相关特性：

var client = new JsonServiceClient("你的API地址");
// 发布模式关闭调试日志，避免不必要的反射操作
#if !DEBUG
client.LogFactory = new NullLogFactory();
#endif

同时确保API对应的DTO类是可序列化的，不要使用匿名类型或动态类型，这类类型在AOT编译环境下会引发异常。

5. 证书验证失败 #

如果你的API使用了自签名证书，iOS发布模式会直接拒绝访问，临时测试可添加以下代码跳过验证：

ServicePointManager.ServerCertificateValidationCallback += (sender, cert, chain, sslPolicyErrors) => true;

注意：正式环境请勿使用此方法，建议更换为正规CA签发的证书。

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