HttpURLConnection 不推荐用于生产环境，因其设计僵硬、API 反直觉、缺乏连接池与重试机制；常见错误包括超时异常、流未关闭及状态非法；OkHttp 是主流替代方案，具备连接池、细粒度超时、简洁 JSON 提交等优势。
HttpURLConnection 是 Java 原生 HTTP 客户端，但不推荐直接用
它不是废弃类，但设计僵硬、API 反直觉、异常处理繁琐，且默认不支持连接池、重试、超时精细控制。生产环境几乎没人裸写 HttpURLConnection，除非受限于极简 JDK 环境（如某些嵌入式 JRE）。
常见错误现象包括：java.net.SocketTimeoutException: connect timed out、java.io.IOException: unexpected end of stream（因未正确关闭 getInputStream() 或未消费响应体）、java.lang.IllegalStateException: Already connected（在调用 connect() 后又改 setRequestProperty()）。
- 必须手动设置
setDoOutput(true)才能发 POST；GET 请求也得显式调用connect()，否则可能不触发请求 - 响应码判断靠
getResponseCode()，但 4xx/5xx 会抛IOException，需用getErrorStream()读取错误体，不能只依赖getInputStream() - 默认无连接复用，每次新建 TCP 连接；要启用 Keep-Alive，得手动加
setRequestProperty("Connection", "keep-alive")，且服务端也得配合
替代方案：OkHttp 是当前最主流的 Java HTTP 客户端
OkHttp 兼容 JDK 8+，API 清晰，内置连接池、GZIP 自动解压、HTTPS 默认校验、拦截器链、Call 取消机制。Spring 5+ 的 WebClient、Retrofit 底层都基于它。
关键差异点：
立即学习“Java免费学习笔记（深入）”；
-
OkHttpClient实例应全局复用（线程安全），而HttpURLConnection每次都要 new - 超时配置粒度更细：
connectTimeout、readTimeout、writeTimeout分开设，不是笼统一个setConnectTimeout() - POST 提交 JSON 更自然：
RequestBody.create(json, MediaType.get("application/json; charset=utf-8"))，不用手动写 OutputStream
OkHttpClient client = new OkHttpClient.Builder()
.connectTimeout(10, TimeUnit.SECONDS)
.readTimeout(30, TimeUnit.SECONDS)
.build();
Request request = new Request.Builder()
.url("https://api.example.com/data")
.header("Authorization", "Bearer token123")
.get()
.build();
try (Response response = client.newCall(request).execute()) {
if (response.isSuccessful()) {
String body = response.body().string(); // 自动关闭流
}
}
Apache HttpClient 仍被大量遗留系统使用
它比 HttpURLConnection 成熟稳定，但 API 较冗长，5.x 版本已转向 Fluent API 和异步支持，不过生态迁移慢。若维护老项目（尤其 Spring Boot 2.1 之前），大概率见到 CloseableHttpClient。
容易踩的坑：
- 必须显式关闭
CloseableHttpClient或用 try-with-resources，否则连接池资源泄漏 -
HttpPost的请求体要用StringEntity或UrlEncodedFormEntity封装，不能直接 setString - 默认不校验 HTTPS 证书（尤其测试环境），但上线前必须关掉
SSLContextBuilder.create().loadTrustMaterial(null, (chain, authType) -> true)这类绕过逻辑
Spring 的 RestTemplate 已进入维护模式，新项目优先选 WebClient
RestTemplate 底层可插拔 HTTP 客户端（默认用 HttpURLConnection，也可配 OkHttp 或 Apache），但它同步阻塞、不支持响应式流。Spring 5 引入的 WebClient 是非阻塞、响应式、函数式风格，底层基于 Netty 或 Reactor Netty。
注意点：
-
WebClient返回的是Mono<ResponseEntity<String>>，必须订阅或用block()（仅测试/命令行工具），否则什么都不会发生 - JSON 反序列化需搭配
Jackson2JsonDecoder，不像RestTemplate那样开箱即用 - 如果项目没上 WebFlux，硬塞
WebClient可能引入不必要的响应式依赖和线程模型混淆
真正需要关心的，是你的 HTTP 调用是否涉及高并发、流式响应、服务间强依赖——这些场景下，HttpURLConnection 的原始性会迅速暴露为运维负担和排查黑洞。
