在 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):
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.From
Seconds(30)
- 添加请求头(如认证):
_httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
- 处理 401/403 等状态码:用
response.StatusCode 判断,不要只依赖异常
- 敏感接口建议封装成独立 Service 类(如
ApiService),解耦 UI 和网络逻辑
基本上就这些。不复杂但容易忽略细节——管好 HttpClient 实例、处理好异常、结构化响应模型,MAUI 的网络请求就很稳。