Java常用网络编程类库与HttpURLConnection_技术教程

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 底层都基于它。

关键差异点：

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。

注意点：