如何为Azure函数应用配置HttpClient超时时间？

问题核心 #

在Azure Functions环境中，直接通过代码设置HttpClient.Timeout无法生效，仍会触发约100秒的默认超时。这是因为Functions宿主环境对出站HTTP请求存在默认限制，会覆盖代码层面的超时配置。

解决方法 #

1. 添加应用设置覆盖出站请求限制 #

Azure Functions提供两个关键应用设置来调整HTTP请求超时，需在函数应用的「应用设置」中配置：

• WEBSITE_HTTP_TIMEOUT：专门控制出站HTTP请求的超时时间，单位为秒。比如设置30分钟就填1800，60分钟填3600
• WEBSITE_TIMEOUT：控制函数应用的整体请求超时，可同步设置为相同值避免冲突

配置完成后需重启函数应用，设置才会生效。

2. 确保HttpClient正确初始化 #

避免因实例管理问题导致超时设置失效，推荐通过依赖注入方式创建HttpClient实例：

// 在Program.cs中注册带超时配置的HttpClient
builder.Services.AddHttpClient("LongTimeoutClient")
    .ConfigureHttpClient(client =>
    {
        client.Timeout = TimeSpan.FromMinutes(30);
    });

// 在函数中注入使用
public class MyFunction
{
    private readonly HttpClient _httpClient;

    public MyFunction(IHttpClientFactory httpClientFactory)
    {
        _httpClient = httpClientFactory.CreateClient("LongTimeoutClient");
    }

    [Function("MyFunction")]
    public async Task Run([HttpTrigger(AuthorizationLevel.Function, "get")] HttpRequest req)
    {
        var response = await _httpClient.GetAsync("https://target-api-url.com");
        // 处理响应逻辑
    }
}

3. 检查运行时版本 #

确保函数应用使用.NET 6及以上版本，旧版本对超时配置的兼容性较差。可在函数应用「配置」→「常规设置」中查看并更新运行时版本。

额外注意 #

• 若目标API自身有响应超时限制，即使本地设置长超时，仍可能被对方中断
• 长时间运行的HTTP请求可能影响函数性能，建议评估是否改用队列+后台任务的异步处理模式

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