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 客户端实现。
立即学习“Java免费学习笔记（深入）”；
一个典型陷阱：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。
