.NET MAUI应用使用HttpClient在iPhone设备启动崩溃问题咨询

启动崩溃由两个配置错误直接导致：

• 手动单独引用6.0.0版本的Microsoft.Extensions.HttpNuGet包。.NET MAUI初版对应.NET 6 SDK已内置匹配版本的Http扩展依赖，手动安装的6.0.0版本和SDK内置依赖存在版本签名差异，Release模式默认开启IL裁剪时会错误删除IHttpClientFactory相关的必要实现类型，DI容器解析服务时直接抛出异常导致启动崩溃。
• 发布参数配置错误。iOS平台不支持JIT动态编译，命令中添加的-p:AotAssemblies=false强制关闭AOT编译，应用启动时会被系统直接拦截终止。

1. 先卸载项目中手动安装的Microsoft.Extensions.Http 6.0.0 NuGet包，SDK已内置对应功能无需额外引用。
2. MauiProgram.cs 注册代码：

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            });

        // 注册类型化HttpClient
        builder.Services.AddHttpClient<EndPointAHttpClient>(client =>
        {
            client.BaseAddress = new Uri("https://www.montemagno.com/");
            client.Timeout = TimeSpan.FromSeconds(15);
        });

        return builder.Build();
    }
}

public class EndPointAHttpClient
{
    public HttpClient Client { get; }

    public EndPointAHttpClient(HttpClient client)
    {
        Client = client;
    }

    // 封装业务请求方法
    public async Task<string> GetPageContentAsync()
    {
        return await Client.GetStringAsync("/");
    }
}

3. 页面调用示例（以MainPage为例）：

public partial class MainPage : ContentPage
{
    private readonly EndPointAHttpClient _httpClient;

    // 构造函数注入客户端
    public MainPage(EndPointAHttpClient httpClient)
    {
        InitializeComponent();
        _httpClient = httpClient;
    }

    protected override async void OnAppearing()
    {
        base.OnAppearing();
        try
        {
            var result = await _httpClient.GetPageContentAsync();
            // 处理返回结果
        }
        catch (Exception ex)
        {
            await DisplayAlert("请求异常", ex.Message, "确认");
        }
    }
}

4. 修正后的iOS发布命令，移除错误的AotAssemblies配置：
   dotnet publish <project.csproj> -f:net6.0-ios -c:Release /p:ServerAddress=<xxx.xxx.xxx.xxx> /p:ServerUser=user /p:TcpPort=58181 /p:ServerPassword=pwd

如果卸载包后仍出现裁剪相关异常，可在项目.csproj文件中添加以下配置排除Http扩展的裁剪：

<ItemGroup>
  <TrimmerRootAssembly Include="Microsoft.Extensions.Http" />
</ItemGroup>

• 不要手动安装和当前MAUI SDK大版本不一致的Microsoft.Extensions.*系列NuGet包，MAUI SDK已内置DI、配置、Http扩展等核心依赖，手动安装版本不匹配的包极易出现依赖冲突。
• iOS真机Release构建必须开启AOT编译，AotAssemblies=false参数仅适用于模拟器调试场景，真机发布必须移除该参数。
• 优先使用类型化客户端（Typed Client）的方式注册和使用HttpClient，不要在业务代码中手动new HttpClient()，避免出现Socket连接耗尽、DNS更新不生效等问题。
• iOS平台推荐使用原生NSUrlSessionHandler作为Http请求的底层处理器，性能更优且自动适配系统网络安全、ATS等配置，注册方式如下：

builder.Services.AddHttpClient<EndPointAHttpClient>(client =>
{
    client.BaseAddress = new Uri("https://www.montemagno.com/");
})
.ConfigurePrimaryHttpMessageHandler(() => new NSUrlSessionHandler
{
    // 可按需配置证书校验、超时等原生参数
});

• 提前配置网络权限：在Info.plist中添加网络访问声明，若需要访问非HTTPS域名，需单独配置NSAppTransportSecurity例外规则，否则请求会被系统拦截。
• Release构建出现Http相关启动崩溃时，优先排查NuGet依赖版本冲突、IL裁剪误删类型问题，不要直接关闭AOT或IL裁剪功能，否则会导致包体积暴涨、应用被App Store拒绝的问题。

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