.NET Maui Blazor Hybrid安卓模拟器中HttpClient.GetAsync无响应求助

针对遇到的问题——在安卓模拟器（Pixel 5，API 34）上点击Fetch按钮触发HttpClient.GetAsync时断点命中但无后续反应、无网络请求，以下是具体的排查方向和解决方法：

1. 检查安卓网络安全配置（API 28+必做） #

安卓API 28及以上默认禁止明文HTTP流量，若请求的是HTTP协议接口（而非HTTPS），需配置允许明文流量或指定信任域名：

• 在Platforms/Android/AndroidManifest.xml的<application>标签中添加属性：

  android:usesCleartextTraffic="true"
  

• 若需精细控制，创建Platforms/Android/Resources/xml/network_security_config.xml文件，内容如下（以信任localhost和本地IP为例）：

  <?xml version="1.0" encoding="utf-8"?>
  <network-security-config>
      <domain-config cleartextTrafficPermitted="true">
          <domain includeSubdomains="true">localhost</domain>
          <domain includeSubdomains="true">10.0.2.2</domain>
      </domain-config>
  </network-security-config>
  

  再在AndroidManifest.xml的<application>标签中关联该配置：

  android:networkSecurityConfig="@xml/network_security_config"
  

2. 确认HttpClient的正确注入与使用 #

MAUI中需使用框架注入的HttpClient，而非手动实例化，否则会缺失平台适配的处理程序：

• 在MauiProgram.cs中确保已注册HttpClient服务：

  builder.Services.AddHttpClient();
  

• 在Home.razor中通过依赖注入获取实例，避免手动new HttpClient()：

  @inject HttpClient Http
  
  <button @onclick="FetchDataAsync">Fetch</button>
  
  @code {
      private async Task FetchDataAsync()
      {
          var response = await Http.GetAsync("你的请求URL");
          // 后续处理逻辑
      }
  }
  

3. 排查异步方法的死锁问题 #

若代码中使用.Result或.Wait()同步阻塞异步方法，会导致UI线程死锁：

• 确保按钮点击方法为async Task类型，全程使用await而非同步阻塞：

  // 错误写法（会导致死锁）
  private void FetchData()
  {
      var response = Http.GetAsync("URL").Result;
  }
  
  // 正确写法
  private async Task FetchDataAsync()
  {
      var response = await Http.GetAsync("URL");
      response.EnsureSuccessStatusCode();
      var content = await response.Content.ReadAsStringAsync();
      // 处理返回内容
  }
  

4. 修正安卓模拟器的网络路由（针对本地API） #

安卓模拟器的localhost指向模拟器自身，若API运行在宿主机器上，需替换为模拟器专属的宿主IP：

• 将请求URL中的localhost替换为10.0.2.2（Android Emulator的宿主映射IP），例如：

  // 修改前
  // var url = "http://localhost:5000/api/data";
  // 修改后
  var url = "http://10.0.2.2:5000/api/data";
  

5. 捕获并查看请求异常 #

在请求方法中添加异常捕获，排查是否有未被抛出的异常：

private async Task FetchDataAsync()
{
    try
    {
        var response = await Http.GetAsync("你的请求URL");
        response.EnsureSuccessStatusCode(); // 触发HTTP状态码异常
        var content = await response.Content.ReadAsStringAsync();
        Console.WriteLine("请求成功：" + content);
    }
    catch (Exception ex)
    {
        Console.WriteLine($"请求失败：{ex.Message}\n{ex.StackTrace}");
    }
}

通过Visual Studio的「输出」窗口（选择「调试」输出）或安卓Logcat查看异常详情，定位具体问题。

6. 更新.NET MAUI版本与模拟器 #

若以上方法无效，可能是版本bug：

• 将.NET MAUI升级至最新稳定版本（通过Visual Studio的NuGet包管理器更新）
• 重启安卓模拟器，或尝试创建新的模拟器实例（API 34）测试

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