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

在 MAUI 中调用 REST API,最常用、推荐的方式就是使用 HttpClient。它跨平台、轻量、支持异步,且与 .NET 生态深度集成。关键不是“能不能用”,而是“怎么用得安全、简洁、可维护”。
✅ 正确创建和管理 HttpClient 实例
别每次请求都 new 一个 HttpClient!这会导致套接字耗尽(尤其是 Android/iOS 上)。正确做法是:
- 在
MauiProgram.cs中注册为单例服务(推荐):
然后在页面或 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# 类(建议用记录类型):
- 在方法中调用:
{
var users = await _httpClient.GetFromJsonAsync
if (users != null)
Console.WriteLine($"共加载 {users.Length} 个用户");
catch (HttpRequestException ex)
{
Console.WriteLine($"网络请求失败:{ex.Message}");
}
✅ POST 请求(发送 JSON 数据)
比如提交登录信息:
- 准备数据对象:
- 序列化并发送:
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 的网络请求就很稳。










