.NET MAUI安卓模拟器调用本地API遭遇HTTP连接失败求助

1. 直接在ContentPage中创建HttpClient是否可行？ #

可以，但不推荐。.NET MAUI允许在页面里实例化HttpClient或通过Refit生成RestService，但这种写法会让页面代码混杂业务逻辑，后期维护、测试都麻烦。先解决连接问题，再聊架构规范。

2. 连接失败的核心排查点 #

（1）确认安卓网络权限 #

安卓项目必须在AndroidManifest.xml中添加联网权限，缺了这个直接连不上：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

如果用了.NET MAUI的权限管理API，也要确保代码里请求了权限（一般默认开启，但保险起见检查）。

（2）本地API的绑定地址要正确 #

你的API不能只绑定localhost，必须绑定0.0.0.0，否则模拟器的10.0.2.2无法映射到主机的服务。在API的Program.cs里加这句：

builder.WebHost.UseUrls("http://0.0.0.0:5223");

这样API会监听所有网卡，模拟器才能访问到。

（3）Refit客户端配置细节 #

检查你的IAPIClient定义和RestService创建逻辑：
假设你的IAPIClient是：

public interface IAPIClient
{
    [Get("/api/data")]
    Task<ApiResponse> GetDataAsync();
}

创建客户端时要保证HttpClient的BaseAddress完全正确：

var httpClient = new HttpClient { BaseAddress = new Uri("http://10.0.2.2:5223") };
var apiClient = RestService.For<IAPIClient>(httpClient);

另外，安卓模拟器对HTTP请求的SSL验证可能有问题，如果API用的是HTTP（非HTTPS），可以临时禁用SSL验证（仅调试用，生产环境绝对不能这么做）：

var handler = new HttpClientHandler();
handler.ServerCertificateCustomValidationCallback = (_, __, ___, ____) => true;
var httpClient = new HttpClient(handler) { BaseAddress = new Uri("http://10.0.2.2:5223") };

（4）主机防火墙拦截 #

主机的防火墙可能挡住了模拟器的请求，先临时关闭防火墙测试，或者给5223端口加一条允许入站的规则。

3. 是否需要ViewModel？ #

必须用，原因很直接：

• 关注点分离：页面只负责UI布局和渲染，ViewModel专门处理API请求、数据逻辑，代码分工明确，不会乱糟糟。
• 异步处理更安全：ViewModel里用ICommand（比如AsyncRelayCommand）处理异步请求，不会在页面生命周期里出现UI阻塞、异步回调异常的问题。
• 可测试性：ViewModel可以脱离UI单独做单元测试，不用依赖ContentPage实例，写测试用例更方便。
• 适配.NET MAUI绑定系统：用ObservableObject实现属性通知，数据变化时UI自动更新，不用手动操作控件。

结合C# Markup的ViewModel示例 #

public class MainViewModel : ObservableObject
{
    private readonly IAPIClient _apiClient;
    private ApiResponse _data;

    public ApiResponse Data
    {
        get => _data;
        set => SetProperty(ref _data, value);
    }

    public ICommand LoadDataCommand { get; }

    public MainViewModel(IAPIClient apiClient)
    {
        _apiClient = apiClient;
        LoadDataCommand = new AsyncRelayCommand(LoadDataAsync);
    }

    private async Task LoadDataAsync()
    {
        try
        {
            Data = await _apiClient.GetDataAsync();
        }
        catch (Exception ex)
        {
            // 这里处理异常，比如弹Toast或提示框
        }
    }
}

然后在ContentPage里绑定ViewModel：

public MainPage(MainViewModel viewModel)
{
    BindingContext = viewModel;

    Content = new VerticalStackLayout
    {
        Children =
        {
            new Label().Bind(Label.TextProperty, nameof(MainViewModel.Data.Content))
        }
    };

    // 页面加载时触发数据加载命令
    Loaded += (s, e) => viewModel.LoadDataCommand.Execute(null);
}

4. 依赖注入的正确姿势 #

别在页面里手动new HttpClient或IAPIClient，用.NET MAUI的DI容器注册：
在MauiProgram.cs中添加：

builder.Services.AddHttpClient<IAPIClient>(client =>
{
    client.BaseAddress = new Uri("http://10.0.2.2:5223");
}).AddTypedClient(RestService.For<IAPIClient>);

builder.Services.AddTransient<MainViewModel>();
builder.Services.AddTransient<MainPage>();

这样ViewModel和Page都会通过构造函数自动获取依赖，不仅符合规范，还能方便替换成Mock客户端做测试。

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