.NET Maui中PostAsync调用时程序无响应问题排查

可能的核心原因 #

• 未设置超时时间：HttpClient默认超时为100秒，若服务器无响应或网络异常，可能导致请求无限挂起，不触发异常。
• 静态HttpClient连接池耗尽：虽推荐使用静态HttpClient，但高并发场景下连接池资源被占用，新请求会等待可用连接，表现为卡住。
• 异步调用同步阻塞：调用PostJason时使用.Wait()或.Result，会导致UI线程死锁，上下文无法释放，请求卡住。
• JSON序列化潜在问题：Order对象偶尔存在null值（如DateCreation、Client），导致JSON格式异常，服务器处理无响应。
• 网络波动导致TCP连接挂起：移动端网络不稳定时，TCP连接建立后无数据传输，HttpClient未检测到连接异常，持续等待。

针对性解决方案 #

1. 配置HttpClient超时与连接池 #

修改静态构造函数，添加超时设置和连接池限制，避免无限等待和连接耗尽：

static RestService()
{
    var handler = new HttpClientHandler
    {
        MaxConnectionsPerServer = 10 // 根据并发需求调整
    };
    _client = new HttpClient(handler);
    _client.Timeout = TimeSpan.FromSeconds(30); // 设置30秒超时，超时后抛出TaskCanceledException
    _serializerOptions = new JsonSerializerOptions();
}

2. 确保异步调用全程使用await #

检查调用PostJason的代码，必须使用await，禁止同步阻塞：

// 正确调用
await RestService.PostJason("/your-endpoint", jsonData);

// 错误调用（会导致死锁，需避免）
RestService.PostJason("/your-endpoint", jsonData).Wait();

3. 完善异常捕获与日志 #

扩展catch块，捕获具体异常类型并记录信息，便于定位问题：

private static async Task PostJason(string endpoint, string json)
{
    try
    {
        var url = $"{_baseUrl}{endpoint}";
        StringContent content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await _client.PostAsync(url, content);
        response.EnsureSuccessStatusCode();
        string responseContent = await response.Content.ReadAsStringAsync();
    }
    catch (TaskCanceledException ex)
    {
        await MessagesHelper.DisplayAlert($"请求超时: {ex.Message}");
        // 可选：写入本地日志文件，记录异常详情和请求参数
    }
    catch (HttpRequestException ex)
    {
        await MessagesHelper.DisplayAlert($"请求失败: {ex.Message}");
    }
    catch (Exception ex)
    {
        await MessagesHelper.DisplayAlert($"未知错误: {ex.Message}");
    }
}

4. 加固JSON序列化逻辑 #

添加空值检查，避免因null导致的JSON格式问题：

public static string CreateInvoiceJson(Order order)
{
    if (order == null) throw new ArgumentNullException(nameof(order));
    if (order.Client == null) throw new ArgumentException("订单的客户信息不能为空", nameof(order));
    order.OrderLines ??= new List<OrderLines>();

    var invoice = new
    {
        id = order.Id,
        reference = order.Reference ?? string.Empty,
        customer_id = order.Client.idEmpresa,
        invoice_date = order.DateCreation?.ToString("yyyy-MM-ddTHH:mm:ss.ffffffZ") ?? DateTime.UtcNow.ToString("yyyy-MM-ddTHH:mm:ss.ffffffZ"),
        importe_anticipo = order.AdvanceAmount,
        lines = CreateOrderLinesJson(order.OrderLines)
    };
    return JsonConvert.SerializeObject(invoice, Formatting.Indented);
}

5. 添加请求取消机制 #

使用CancellationToken手动取消长时间未响应的请求，双重保障超时处理：

// 修改方法参数，支持取消令牌
private static async Task PostJason(string endpoint, string json, CancellationToken cancellationToken = default)
{
    try
    {
        var url = $"{_baseUrl}{endpoint}";
        StringContent content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await _client.PostAsync(url, content, cancellationToken);
        response.EnsureSuccessStatusCode();
        string responseContent = await response.Content.ReadAsStringAsync(cancellationToken);
    }
    // 异常捕获逻辑同上
}

// 调用示例：设置30秒超时令牌
var cts = new CancellationTokenSource(TimeSpan.FromSeconds(30));
await RestService.PostJason("/your-endpoint", jsonData, cts.Token);

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