.NET MAUI中Application构造函数使用HttpClient引发Win32异常

这个问题我之前做MAUI项目时也踩过同款坑，核心原因确实和.NET MAUI的应用生命周期、同步上下文的特殊处理脱不了干系，和WPF的运行机制差异很大：

为什么MAUI里会触发Win32异常？ #

• 构造函数执行时机的问题：MAUI的App构造函数是在应用初始化的早期同步阶段执行的，这时候Windows平台下的WinUI3同步上下文还没完全建立就绪。你在这里调用TestAsync()却没有等待（构造函数不能标记为async），属于典型的“火并忘记”异步调用，很容易出问题。
• 同步上下文的差异：WPF的窗口构造函数执行时，DispatcherSynchronizationContext已经完全就绪，异步操作完成后能正确回到UI线程恢复执行；但MAUI在App构造阶段，WinUI3的同步上下文还在初始化中，当await尝试恢复到这个未就绪的上下文时，就会触发底层的Win32未处理异常。
• 异常处理机制不同：WPF对这种未等待的异步异常有更宽松的处理逻辑，不会直接导致进程崩溃；但MAUI在Windows平台下，应用初始化阶段的未处理异常会直接传递到Win32层面，引发崩溃。

正确的解决方案 #

方案1：使用应用生命周期事件（推荐） #

把异步操作移到应用初始化完成后的生命周期事件中，比如OnLaunched（通过MauiProgram配置），此时同步上下文已经就绪，而且可以安全地等待异步操作：

// MauiProgram.cs
using Microsoft.Maui.LifecycleEvents;
using System.IO;

namespace YourAppNamespace;

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

        // 配置Windows平台的生命周期事件
        builder.ConfigureLifecycleEvents(events =>
        {
#if WINDOWS
            events.AddWindows(windowsLifecycle =>
            {
                windowsLifecycle.OnLaunched(async (app, args) =>
                {
                    await TestAsync();
                });
            });
#endif
        });

        return builder.Build();
    }

    private static async Task TestAsync()
    {
        // 使用using确保HttpClient被正确释放
        using HttpClient lClient = new HttpClient();
        var lReponse = await lClient.GetAsync(new Uri("https://proof.ovh.net/files/1Mb.dat"));
        // 确保请求成功，避免后续处理无效内容
        lReponse.EnsureSuccessStatusCode();

        // MAUI中不要硬编码路径，用FileSystem获取合法的应用数据目录
        string savePath = Path.Combine(FileSystem.AppDataDirectory, "test.dat");
        using (var fs = new FileStream(savePath, FileMode.CreateNew))
        {
            await lReponse.Content.CopyToAsync(fs);
        }
    }
}

方案2：重写App类的OnStart方法 #

如果你更倾向于在App类内部处理，可以重写OnStart方法（注意这里只能用async void，因为OnStart是void返回类型，一定要做好异常捕获）：

public partial class App : Application
{
    public App()
    {
        InitializeComponent();
    }

    protected override async void OnStart()
    {
        base.OnStart();
        try
        {
            await TestAsync();
        }
        catch (Exception ex)
        {
            // 捕获并处理异常，避免应用崩溃
            Console.WriteLine($"下载或保存文件出错：{ex.Message}");
            // 也可以显示UI提示给用户
        }
    }

    private async Task TestAsync()
    {
        using HttpClient lClient = new HttpClient();
        var lReponse = await lClient.GetAsync(new Uri("https://proof.ovh.net/files/1Mb.dat"));
        lReponse.EnsureSuccessStatusCode();

        string savePath = Path.Combine(FileSystem.AppDataDirectory, "test.dat");
        using (var fs = new FileStream(savePath, FileMode.CreateNew))
        {
            await lReponse.Content.CopyToAsync(fs);
        }
    }
}

额外注意事项 #

• 永远不要在UI框架的构造函数里调用未等待的异步方法，这是跨框架的不良实践，容易导致状态不一致和未处理异常。
• MAUI是跨平台框架，不要硬编码本地路径（比如C:\test.dat），否则在Android、iOS等平台会直接报错，而且Windows平台下WinUI3应用有文件访问权限限制，直接写入C盘根目录可能会被拒绝。
• 生产环境中建议使用IHttpClientFactory来创建HttpClient，而不是每次新建实例，这样可以避免socket耗尽等问题。

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