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

来源：这里教程网时间：2026-02-21 17:33:55 作者：

在 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 的网络请求就很稳。