本文详解如何将基于 Apache HttpClient 3.x/4.x 的 NTLM 认证代码（使用 NTCredentials 和 AuthSchemes）平滑迁移至 HttpClient 5.x，涵盖凭据提供器、认证范围、认证方案枚举及密码安全传递等关键变更。
本文详解如何将基于 apache httpclient 3.x/4.x 的 ntlm 认证代码（使用 `ntcredentials` 和 `authschemes`）平滑迁移至 httpclient 5.x，涵盖凭据提供器、认证范围、认证方案枚举及密码安全传递等关键变更。
Apache HttpClient 5 是重大重构版本，包结构、API 设计和认证模型均发生显著变化。原 org.apache.commons.httpclient（已废弃）及早期 org.apache.httpcomponents:httpclient（4.x）中的 NTLM 配置方式无法直接复用。以下是迁移的核心要点与完整可运行示例。
✅ 关键变更说明
-
认证范围（
AuthScope）：AuthScope.ANY已弃用，应替换为new AuthScope(null, -1)（表示匹配任意主机和端口）； -
凭据类型（
NTCredentials）：密码参数由String改为char[]，提升安全性（避免字符串常量池残留）； -
认证方案枚举：
AuthSchemes.NTLM→StandardAuthScheme.NTLM（位于org.apache.hc.client5.http.auth包）； -
超时配置（如需）：
RequestConfig.setConnectTimeout()等方法已统一接受Timeout对象，例如Timeout.ofSeconds(30)或Timeout.of(30, TimeUnit.SECONDS)； -
包路径更新：所有类均迁移至
org.apache.hc.client5.*命名空间（如BasicCredentialsProvider,HttpClients,StandardAuthScheme）。
✅ 迁移后完整代码示例
import org.apache.hc.client5.http.auth.AuthScope;
import org.apache.hc.client5.http.auth.CredentialsProvider;
import org.apache.hc.client5.http.auth.StandardAuthScheme;
import org.apache.hc.client5.http.auth.UsernamePasswordCredentials;
import org.apache.hc.client5.http.config.RequestConfig;
import org.apache.hc.client5.http.impl.auth.BasicCredentialsProvider;
import org.apache.hc.client5.http.impl.classic.CloseableHttpClient;
import org.apache.hc.client5.http.impl.classic.HttpClients;
import org.springframework.http.client.HttpComponentsClientHttpRequestFactory;
import org.springframework.web.client.RestTemplate;
// ... 在方法内
String url = "https://intranet.example.com/api/data";
String user = "DOMAIN\username"; // 或 "username"（若已指定 domain）
String pass = "P@ssw0rd";
String host = "intranet.example.com"; // 发起请求的目标主机（用于 NTLM 会话协商）
String domain = "DOMAIN"; // Windows 域名（区分大小写）
// 1. 构建凭据提供器（注意：密码必须为 char[]）
CredentialsProvider credsProvider = new BasicCredentialsProvider();
credsProvider.setCredentials(
new AuthScope(null, -1), // 匹配任意目标 — 等效于旧版 AuthScope.ANY
new UsernamePasswordCredentials(user, pass.toCharArray(), domain) // 注意：HttpClient 5 使用 UsernamePasswordCredentials + domain 参数
);
// 2. 配置请求级认证策略（优先启用 NTLM）
RequestConfig requestConfig = RequestConfig.custom()
.setTargetPreferredAuthSchemes(List.of(StandardAuthScheme.NTLM))
.build();
// 3. 创建 HttpClient 实例
CloseableHttpClient httpClient = HttpClients.custom()
.setDefaultCredentialsProvider(credsProvider)
.setDefaultRequestConfig(requestConfig)
.build();
// 4. 集成到 Spring RestTemplate
HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory();
factory.setHttpClient(httpClient);
RestTemplate restTemplate = new RestTemplate(factory);
// 执行请求
return restTemplate.getForObject(url, String.class);
⚠️ 重要注意事项：
Apache Superset Dashboard and SQL Exploration Skill下载Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- HttpClient 5 中
NTCredentials类已被移除，统一使用UsernamePasswordCredentials并通过构造函数第三个参数传入domain（见上例）；- 若使用 Kerberos + NTLM 混合环境，需额外配置
GSSAuthenticationHandler和 JAAS，本文聚焦纯 NTLM 场景；host参数在 HttpClient 5 中不再显式传入凭据对象，而是由 HTTP 请求的Host头和实际连接目标自动识别，因此UsernamePasswordCredentials构造中无需host；- 生产环境务必避免硬编码密码，推荐使用
SecureString（Java 9+）或密钥管理服务（如 HashiCorp Vault）进行凭据注入。
✅ 总结
从旧版迁移到 HttpClient 5 的 NTLM 认证，本质是适配其更严格的凭据抽象（char[] 密码）、标准化的认证方案枚举（StandardAuthScheme）以及语义更清晰的 AuthScope。只要按上述方式更新依赖、调整构造参数并修正导入路径，即可无缝支持 Windows 域环境下的安全调用。建议同步升级 Spring Framework 至 6.x（兼容 HttpClient 5），以获得完整的响应式与连接池优化能力。
