.NET 9中ServicePointManager已过时，如何用HttpClient配置TLS协议？

开发者阿泽

2026-6-12

.NET 9中配置HttpClient TLS协议的正确方式

关于.NET 9对遗留代码的处理

.NET 9不会自动迁移ServicePointManager这类遗留代码的行为，但默认情况下，包括.NET 9在内的现代.NET版本中，HttpClient已经默认优先使用TLS 1.3，同时兼容TLS 1.2，绝大多数业务场景下无需手动设置协议版本。只有当你有强制指定协议版本的需求时，才需要显式配置。

用SocketsHttpHandler配置TLS协议的正确步骤

SocketsHttpHandler是.NET Core 2.1+及.NET 5+的默认HTTP处理器，也是替代ServicePointManager的现代方案，配置步骤如下：

创建SocketsHttpHandler实例，通过SslOptions.EnabledSslProtocols指定需要启用的TLS版本
将该处理器传入HttpClient的构造函数
重点：务必复用HttpClient实例，不要每次请求都新建，避免出现socket资源耗尽问题

基础示例代码

// 配置SocketsHttpHandler
var socketHandler = new SocketsHttpHandler
{
    SslOptions = new SslClientAuthenticationOptions
    {
        EnabledSslProtocols = SslProtocols.Tls12 | SslProtocols.Tls13
        // 如有需要，可在此添加证书验证、回调等其他SSL配置
    }
};

// 创建可复用的HttpClient实例
var httpClient = new HttpClient(socketHandler);

// 使用HttpClient发起请求
var response = await httpClient.GetAsync("https://your-target-url.com");
response.EnsureSuccessStatusCode();

ASP.NET Core依赖注入场景下的配置

如果是在ASP.NET Core项目中通过依赖注入管理HttpClient，可以通过AddHttpClient的重载直接配置处理器：

builder.Services.AddHttpClient("CustomTlsClient")
    .ConfigurePrimaryHttpMessageHandler(() => new SocketsHttpHandler
    {
        SslOptions = new SslClientAuthenticationOptions
        {
            EnabledSslProtocols = SslProtocols.Tls12 | SslProtocols.Tls13
        }
    });