Java 20中使用uri.toURL().openConnection()是否为最佳实践？

首先明确：uri.toURL().openConnection()这种方式并非最佳选择，而且你现有代码里的Paths.get(apiUrl)存在逻辑错误——Paths.get()是用来处理本地文件系统路径的，不是网络URL，直接用它处理API地址会导致URI格式错误，正确的做法应该是用URI.create(apiUrl)直接创建网络URI。

为什么不推荐用uri.toURL().openConnection()？ #

虽然URI.toURL()方法本身没被弃用，但Java 20中URL类的大部分方法（比如URLConnection的部分旧API）已被标记为弃用，原因是URL类设计存在固有缺陷：

• 实例不可变，无法动态调整参数
• 处理协议时缺乏灵活性，对现代HTTP特性支持不足
• 安全限制较多，默认连接池配置简陋

推荐的替代方案 #

1. 使用Java 11+内置的HttpClient（首选）

这是官方推荐的现代HTTP客户端，完全替代旧的HttpURLConnection，支持同步/异步请求、HTTP/2、请求体构建、响应处理等特性，代码更简洁健壮：

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class HttpExample {
    public static void main(String[] args) throws Exception {
        String apiUrl = "https://your-api-url.com";
        HttpClient client = HttpClient.newHttpClient();
        
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(apiUrl))
                .GET() // 可替换为POST等方法
                .build();
        
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

2. 若需兼容旧代码，优化现有写法

如果必须沿用URLConnection体系，先修正路径处理错误，再使用URI直接创建连接（注意这只是过渡方案，长期还是建议迁移到HttpClient）：

import java.net.URI;
import java.net.HttpURLConnection;

public class OldConnectionExample {
    public static void main(String[] args) throws Exception {
        String apiUrl = "https://your-api-url.com";
        URI uri = URI.create(apiUrl);
        
        // 虽然toURL()可用，但URL类已被标记为弃用，不推荐长期使用
        HttpURLConnection connection = (HttpURLConnection) uri.toURL().openConnection();
        connection.setRequestMethod("GET");
        
        // 后续的连接处理逻辑...
    }
}

内容的提问来源于stack exchange，提问作者Swapnil Sharma