6.17Unified Configuration of the HttpClient Client

Created on Aug 17, 2026~1 min read

In application project development, it is often necessary to uniformly configure all HttpClient client instances. To this end, the framework provides the ConfigureHttpClientDefaults method, which supports one-click configuration:

cs
services.ConfigureHttpClientDefaults(clientBuilder =>{    clientBuilder.ConfigurePrimaryHttpMessageHandler(() => new HttpClientHandler());});// Or use the IHttpRemoteBuilder extension method for one-click configurationservices.AddHttpRemote()    .ConfigureHttpClientDefaults(clientBuilder =>    {        clientBuilder.ConfigurePrimaryHttpMessageHandler(() => new HttpClientHandler());    });

In this way, you can easily set a default HttpMessageHandler for all HttpClient instances, ensuring configuration consistency and maintainability.