MAUI怎么调用REST API MAUI网络请求HttpClient方法

在 MAUI 中调用 REST API 应使用单例注册的 HttpClient，避免频繁创建导致套接字耗尽；通过构造函数注入后，可用 GetFromJsonAsync 安全获取 JSON 数据并映射为 record 类型。

在 MAUI 中调用 REST API，最常用、推荐的方式就是使用 HttpClient。它跨平台、轻量、支持异步，且与 .NET 生态深度集成。关键不是“能不能用”，而是“怎么用得安全、简洁、可维护”。

✅ 正确创建和管理 HttpClient 实例

别每次请求都 new 一个 HttpClient！这会导致套接字耗尽（尤其是 Android/iOS 上）。正确做法是：

• 在 MauiProgram.cs 中注册为单例服务（推荐）：

builder.Services.AddSingleton();

然后在页面或 ViewModel 中通过构造函数注入使用：

public partial class MainPage : ContentPage
{
  private readonly HttpClient _httpClient;

  public MainPage(HttpClient httpClient)
  {
    _httpClient = httpClient;
    InitializeComponent();
  }
}

✅ 发起 GET 请求（获取 JSON 数据）

以请求一个用户列表为例（如 https://jsonplaceholder.typicode.com/users）：

• 定义匹配的 C# 类（建议用记录类型）：

public record User(int Id, string Name, string Email);

• 在方法中调用：

try
{
  var users = await _httpClient.GetFromJsonAsync("https://jsonplaceholder.typicode.com/users");
  if (users != null)
    Console.WriteLine($"共加载 {users.Length} 个用户");
catch (HttpRequestException ex)
{
  Console.WriteLine($"网络请求失败：{ex.Message}");
}

✅ POST 请求（发送 JSON 数据）

比如提交登录信息：

• 准备数据对象：

var loginData = new { username = "test", password = "123" };

• 序列化并发送：

var json = JsonSerializer.Serialize(loginData);
var content = new StringContent(json, Encoding.UTF8, "application/json");

var response = await _httpClient.PostAsync("https://api.example.com/login", content);
if (response.IsSuccessStatusCode)
{
  var result = await response.Content.ReadFromJsonAsync();
}

✅ 补充建议（避坑要点）

• 设置超时：可在构造 HttpClient 时指定 TimeSpan.FromSeconds(30)
• 添加请求头（如认证）：_httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
• 处理 401/403 等状态码：用 response.StatusCode 判断，不要只依赖异常
• 敏感接口建议封装成独立 Service 类（如 ApiService），解耦 UI 和网络逻辑

基本上就这些。不复杂但容易忽略细节——管好 HttpClient 实例、处理好异常、结构化响应模型，MAUI 的网络请求就很稳。