.NET MAUI中无法捕获WebException/HttpRequestException网络异常的问题

核心原因分析 #

你遇到的无法捕获异常、程序直接崩溃的情况，通常由以下几种原因导致：

1. 异步方法未正确await
   调用HttpClient.GetAsync时如果没加await关键字，返回的Task会在后台执行，其抛出的异常会成为未观察到的Task异常，这种异常不会被局部try-catch捕获，最终导致程序崩溃。

2. 同步网络请求阻塞UI线程（平台限制）
   使用WebRequest.GetResponse这类同步方法时，若直接在UI线程调用，Android平台会触发NetworkOnMainThreadException——这是Android的强制限制，该异常可能绕过你的try-catch直接导致崩溃；iOS平台也有类似的主线程阻塞限制。

3. 异常类型捕获范围不足
   未知主机场景下，可能抛出的异常不止WebException或HttpRequestException，比如底层的SocketException、被包装的AggregateException等，你的try-catch只捕获了特定类型，导致漏抓。

4. 未配置全局异常处理
   .NET MAUI中存在一些未被局部try-catch捕获的全局异常，比如后台任务的异常，需要通过全局事件监听来捕获。

针对性解决方案 #

1. 确保异步方法正确使用await #

调用HttpClient.GetAsync时必须搭配await，并将方法标记为async：

private async Task CheckHttpClientConnection()
{
    try
    {
        using var httpClient = new HttpClient();
        var response = await httpClient.GetAsync("https://lol.click/api/v1");
        response.EnsureSuccessStatusCode();
        // 处理成功逻辑
    }
    catch (HttpRequestException ex)
    {
        // 捕获HTTP请求异常
        Console.WriteLine($"HttpClient异常: {ex.Message}");
    }
    catch (Exception ex)
    {
        // 兜底捕获所有异常
        Console.WriteLine($"未知异常: {ex.Message}");
    }
}

2. 将同步网络请求移至后台线程 #

用Task.Run把WebRequest的同步操作放到后台线程执行，避免触发平台UI线程限制：

private async Task CheckWebRequestConnection()
{
    try
    {
        await Task.Run(() =>
        {
            var request = WebRequest.CreateHttp("https://lol.click/api/v1");
            using var response = request.GetResponse();
            // 处理成功逻辑
        });
    }
    catch (WebException ex)
    {
        Console.WriteLine($"WebRequest异常: {ex.Message}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"未知异常: {ex.Message}");
    }
}

3. 扩大异常捕获范围 #

先用catch (Exception)捕获所有异常，确认具体异常类型后，再针对性添加特定类型的捕获分支：

try
{
    // 网络请求代码
}
catch (HttpRequestException ex)
{
    // 处理HTTP请求异常
}
catch (WebException ex)
{
    // 处理WebRequest异常
}
catch (SocketException ex)
{
    // 处理底层套接字异常（未知主机场景常见）
}
catch (Exception ex)
{
    // 兜底处理所有其他异常
}

4. 添加全局异常处理 #

在App.xaml.cs中注册全局异常监听，捕获所有未被局部处理的异常：

public App()
{
    InitializeComponent();

    // 处理未捕获的全局异常
    AppDomain.CurrentDomain.UnhandledException += (sender, e) =>
    {
        var exception = e.ExceptionObject as Exception;
        Console.WriteLine($"全局未处理异常: {exception?.Message}");
    };

    // 处理Task未观察到的异常
    TaskScheduler.UnobservedTaskException += (sender, e) =>
    {
        Console.WriteLine($"未观察到的Task异常: {e.Exception.Message}");
        e.SetObserved(); // 标记异常已处理，避免程序崩溃
    };

    MainPage = new MainPage();
}

额外检查项 #

• 确认项目已添加网络权限：在Platforms/Android/AndroidManifest.xml中添加<uses-permission android:name="android.permission.INTERNET" />；iOS平台若使用HTTP链接，需在Platforms/iOS/Info.plist中配置App Transport Security例外。
• 测试时确保设备/模拟器处于可复现未知主机的网络环境（比如断网或使用无效域名）。

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