ASP.NET Core调用第三方API时Postman无返回、SendAsync卡住求助

核心问题点 #

1. 服务生命周期不匹配：你将IHolidayService注册为单例（Singleton），而通过IHttpClientFactory创建的HttpClient设计为随短暂/作用域服务生命周期更新，单例服务会长期持有过期的HttpClient实例，导致请求Handler失效、网络连接异常，最终引发请求卡住。
2. 缺少基础配置与异常校验：你没有对第三方API请求做基础校验，也没有配置必要的请求头、超时规则，部分公开API会拒绝没有User-Agent的请求，无超时配置会导致请求失败时无限等待。
3. 反序列化配置缺失：System.Text.Json默认区分大小写，若API返回的JSON属性名与你的模型大小写不匹配，会导致反序列化失败。
4. （可选）未规避死锁风险：异步方法未加ConfigureAwait(false)，如果存在同步调用异步接口的场景，会触发上下文死锁。

修复步骤 #

1. 修正服务注册配置
   修改Startup.cs里的服务注册代码，将HolidayService的生命周期改为作用域（Scoped），与IHttpClientFactory的管理逻辑匹配，同时补充HttpClient的基础配置：

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers();
    // 先注册HttpClient
    services.AddHttpClient("PublicHolidaysApi", c => 
    {
        c.BaseAddress = new Uri("https://api.xmltime.com/");
        // 配置超时时间，避免无限等待
        c.Timeout = TimeSpan.FromSeconds(15);
        // 补充User-Agent，大部分公开API要求该请求头
        c.DefaultRequestHeaders.UserAgent.ParseAdd("HolidayApiClient/1.0");
    });
    // 改为Scoped生命周期
    services.AddScoped<IHolidayService, HolidayService>();
}

注意BaseAddress末尾加斜杠，避免路径拼接错误。

2. 优化服务层请求逻辑
   补充响应状态校验，添加ConfigureAwait(false)规避死锁：

public async Task<List<Holiday>> GetHolidays(string country, int year)
{
    var request = new HttpRequestMessage(HttpMethod.Get, $"holidays?accesskey=assdthf&secretkey=dffrnp7fvfaYq0u&version=3&country={country}&year={year}&lang=en");
    var response = await _client.SendAsync(request).ConfigureAwait(false);
    // 校验响应状态，4xx/5xx会直接抛出异常，方便定位问题
    response.EnsureSuccessStatusCode();
    using var responseStream = await response.Content.ReadAsStreamAsync().ConfigureAwait(false);
    // 反序列化添加不区分大小写配置
    return await JsonSerializer.DeserializeAsync<List<Holiday>>(
        responseStream, 
        new JsonSerializerOptions { PropertyNameCaseInsensitive = true }
    ).ConfigureAwait(false);
}

3. 前置验证API可用性
   将你拼接的完整请求URL（例：https://api.xmltime.com/holidays?accesskey=assdthf&secretkey=dffrnp7fvfaYq0u&version=3&country=cn&year=2024&lang=en）直接复制到Postman/浏览器中调用，确认API密钥、参数正确，网络可达，排除第三方API本身权限、限流、参数错误的问题。

如果完成以上修改后仍有问题，可以通过抓包工具查看请求是否正常发出，确认是否存在本地防火墙、代理拦截请求的情况。

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