Java常用网络协议类库与URLConnection_技术教程

URLConnection 因缺乏重定向、连接池、JSON 支持及默认超时等能力而被弃用；推荐 OkHttp（API 简洁、性能好）、Apache HttpClient（稳定但繁琐）或 Java 11+ HttpClient（标准库、轻量），Spring 项目优先选 WebClient。

Java 自带的 URLConnection 能发 HTTP 请求，但实际项目中几乎没人直接用它——不是不能用，而是太原始、易出错、难维护。

为什么 `URLConnection` 在真实项目中基本被弃用

它不自动处理重定向（setInstanceFollowRedirects(false) 默认关）、不复用连接、不支持连接池、没有内置 JSON 解析、连 POST 表单提交都要手动拼 Content-Type 和字节

流。更麻烦的是，它对 HTTPS 的证书验证、超时设置、代理配置等都得自己写样板代码。

URLConnection 没有默认超时：不显式调用 setConnectTimeout() 和 setReadTimeout()，请求可能无限卡住
POST 提交 JSON 时，必须手动设 connection.setRequestProperty("Content-Type", "application/json; charset=utf-8")，且 getOutputStream() 写完后必须 flush() + close()，否则服务端收不到完整体
响应状态码要自己读 getResponseCode()，4xx/5xx 不抛异常，容易漏判错误

替代方案：Apache HttpClient vs OkHttp vs Java 11+ `HttpClient`

三者都能解决 URLConnection 的硬伤，但适用场景不同：

Apache HttpClient（org.apache.httpcomponents:httpclient）：成熟稳定，企业老项目常见，但 API 繁琐，Builder 模式嵌套深，CloseableHttpClient 必须显式 close()
OkHttp（com.squareup.okhttp3:okhttp）：Android 原生支持，性能好、API 简洁，OkHttpClient 是线程安全的可复用实例，推荐新项目首选
Java 11+ 内置 java.net.http.HttpClient：标准库、无额外依赖，支持异步 CompletableFuture，但缺少拦截器、日志、重试等高级能力，适合轻量需求

如果你用的是 Spring 生态，RestTemplate（已标记为 deprecated）或 WebClient（推荐）才是更自然的选择，它们底层可插拔替换 HTTP 客户端实现。

一个典型陷阱：URL 中含中文或空格导致 `MalformedURLException`

很多人直接把带中文的 URL 传给 new URL(...)，结果抛 java.net.MalformedURLException: no protocol 或解析失败。这不是协议问题，是没做 URI 编码。

正确做法是先构造 URI，再转 URL：

String base = "https://api.example.com/search";
String keyword = "Java 编程";
try {
    URI uri = new URI(base + "?q=" + URLEncoder.encode(keyword, StandardCharsets.UTF_8));
    URL url = uri.toURL(); // 这样才安全
} catch (URISyntaxException | IOException e) {
    // 处理编码或协议错误
}

注意：URLEncoder.encode() 编码的是 form 表单值（会把空格变 +），不是完整 URL；若用于路径段（如 /user/张三），得用 URLEncoder.encode(..., "UTF-8").replace("+", "%20") 或改用 java.net.URI 构造器逐段传参。

别在循环里反复 new `URLConnection` 或 `HttpClient`

每次 new 都新建 TCP 连接（除非手动配了 keep-alive），高并发下会快速耗尽本地端口或触发 TIME_WAIT。正确方式是复用客户端实例：

OkHttp：全局单例 OkHttpClient，它内部自带连接池和 DNS 缓存
Apache HttpClient：用 PoolingHttpClientConnectionManager 管理连接池，CloseableHttpClient 可复用
Java 11 HttpClient：本身就是设计为复用的，建议 HttpClient.newBuilder().build() 后长期持有

临时创建客户端看似简单，实则埋下性能雷——连接建立耗时远大于请求本身，尤其 HTTPS 还要握手加 TLS。