ASP.NET Core Mvc 如何为命名HttpClient默认传递查询参数

要为通过IHttpClientFactory注册的命名HttpClient默认追加固定查询参数，最稳妥无侵入的方案是使用自定义委托处理器DelegatingHandler，在请求管道中统一修改请求URI，不需要改动任何业务侧请求代码。

具体实现步骤 #

1. 编写自定义查询参数追加处理器 #

这个处理器会在每次请求发出前自动执行，检查请求URI中是否存在api_key参数，不存在则自动追加，不会覆盖请求自带的其他查询参数：

public class TmdbApiKeyHandler : DelegatingHandler
{
    private const string ApiKeyParamName = "api_key";
    private readonly string _apiKeyValue;

    public TmdbApiKeyHandler(string apiKeyValue)
    {
        _apiKeyValue = apiKeyValue;
    }

    protected override Task<HttpResponseMessage> SendAsync(
        HttpRequestMessage request, 
        CancellationToken cancellationToken)
    {
        var uriBuilder = new UriBuilder(request.RequestUri!);
        var queryCollection = System.Web.HttpUtility.ParseQueryString(uriBuilder.Query);
        
        // 避免重复追加api_key
        if (string.IsNullOrWhiteSpace(queryCollection[ApiKeyParamName]))
        {
            queryCollection[ApiKeyParamName] = _apiKeyValue;
        }

        uriBuilder.Query = queryCollection.ToString();
        request.RequestUri = uriBuilder.Uri;

        return base.SendAsync(request, cancellationToken);
    }
}

2. 为指定命名HttpClient注册处理器 #

修改你现有的MoviesDBClient注册代码，仅为该客户端绑定上述处理器，不会影响项目中其他HttpClient实例：

// 建议从配置文件读取密钥，不要硬编码在代码中
var tmdbApiKey = builder.Configuration["TmdbSettings:ApiKey"];

builder.Services.AddHttpClient(name: "MoviesDBClient", 
    configureClient: options =>
    {
        options.BaseAddress = new Uri("https://api.themoviedb.org/3/");
        options.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(
            "application/json", 1.0));
    })
    // 绑定自定义处理器
    .AddHttpMessageHandler(() => new TmdbApiKeyHandler(tmdbApiKey));

注意事项 #

• 不建议直接把api_key拼在BaseAddress中：这种写法在请求自带其他查询参数时会出现URI拼接错误，兼容性很差，仅适合完全无自定义查询参数的极简场景。
• 不要将该处理器注册为全局消息处理器：否则项目中所有HttpClient发起的请求都会被追加api_key参数，仅为需要的命名/类型化客户端单独注册即可。
• 注册处理器时不要用单例生命周期注册自定义Handler，保持默认的短生命周期即可，避免出现密钥值更新不生效、依赖注入生命周期不匹配的问题。

配置完成后，所有通过IHttpClientFactory.CreateClient("MoviesDBClient")创建的客户端发起的请求，都会自动携带api_key查询参数，业务代码中不需要做任何额外拼接操作。

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