Avalonia浏览器端HTTP请求同步等待报错，求跨端兼容方案

问题本质 #

浏览器端（WASM）的.NET运行时不支持阻塞式等待异步任务（如Task.Wait()、.GetAwaiter().GetResult()），因为WASM采用单线程模型，阻塞操作会直接触发PlatformNotSupportedException，也就是你遇到的"Cannot wait on monitors on this runtime"错误。

实现方案 #

1. 异步改造初始化方法 #

虽然OnFrameworkInitializationCompleted返回void，但可以声明为async void（仅适合这类无返回的初始化/事件方法），配合await处理HTTP请求，同时做好异常捕获：

public override async void OnFrameworkInitializationCompleted()
{
    try
    {
        var appState = await FetchAppStateAsync();
        // 这里写获取到状态后的初始化逻辑，比如注入状态、启动主窗口等
    }
    catch (Exception ex)
    {
        // 异常处理：日志记录、弹窗提示等
        Console.WriteLine($"初始化请求失败: {ex.Message}");
    }

    base.OnFrameworkInitializationCompleted();
}

// 跨端复用的异步HTTP请求方法
private async Task<TState> FetchAppStateAsync()
{
    using var client = new HttpClient();
    var content = await client.GetStringAsync(_apiBaseUrl);
    return Deserialize<TState?>(content) ?? new TState();
}

2. 跨端代码复用保障 #

• 上述FetchAppStateAsync方法完全兼容Avalonia的桌面端（Windows/macOS/Linux）和浏览器端，HttpClient在各平台的Avalonia实现中已做适配，无需额外修改。
• 核心原则：全平台统一使用异步非阻塞模式处理I/O操作，避免任何同步阻塞写法。

3. 异常处理进阶（可选） #

如果担心async void的异常扩散问题，可以用ContinueWith封装初始化逻辑：

private async Task InitializeAppAsync()
{
    var appState = await FetchAppStateAsync();
    // 初始化逻辑
}

public override void OnFrameworkInitializationCompleted()
{
    _ = InitializeAppAsync().ContinueWith(task =>
    {
        if (task.IsFaulted)
        {
            Console.WriteLine($"初始化异常: {task.Exception?.InnerException?.Message}");
        }
    }, TaskScheduler.FromCurrentSynchronizationContext());

    base.OnFrameworkInitializationCompleted();
}

这种写法同样不会阻塞UI线程，且能安全捕获异步任务中的异常，兼容所有Avalonia平台。

重要提醒 #

• WASM平台下所有网络I/O必须用异步非阻塞方式，同步阻塞操作会直接触发平台不支持的错误。
• 无论桌面还是浏览器端，用await处理异步操作都能避免UI线程卡顿，是跨端开发的最佳实践。

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