Java代码迁移至HTTP/3需进行哪些代码调整？

核心结论 #

先给你明确答案：HTTP/3的改动集中在传输层（L3/L4），应用层（L7）的Java业务代码几乎不需要做任何修改，兼容工作主要在JDK底层或者第三方依赖库层面完成。

JDK原生HttpClient的现状 #

截至OpenJDK 20版本，java.net.http.HttpClient.Version里只有HTTP_1_1和HTTP_2两个枚举值，原生HttpClient默认优先使用HTTP/2，暂未支持HTTP/3。不过OpenJDK社区已经在推进HTTP/3的支持计划，后续版本会逐步加入该特性。

代码调整方案 #

客户端侧

如果现在就要使用HTTP/3，原生JDK暂时无法支持，需要依赖第三方库（比如OkHttp、Apache HttpClient的HTTP/3扩展）。以OkHttp为例，调整后的示例代码如下：

// 先引入OkHttp的HTTP/3相关依赖
OkHttpClient client = new OkHttpClient.Builder()
        .protocols(List.of(Protocol.HTTP_3, Protocol.HTTP_2, Protocol.HTTP_1_1))
        .build();

Request request = new Request.Builder()
        .url("https://example.com")
        .get()
        .build();

try (Response response = client.newCall(request).execute()) {
    if (response.isSuccessful()) {
        System.out.println(response.body().string());
    }
} catch (IOException e) {
    e.printStackTrace();
}

若等待原生JDK支持，后续版本（如JDK 21及以后）只需在构建HttpClient时指定协议版本即可，示例代码如下：

var response = HttpClient.newBuilder()
        .version(HttpClient.Version.HTTP_3) // 待JDK支持后可用
        .build()
        .send(HttpRequest.newBuilder(URI.create("https://example.com"))
                        .GET()
                        .build(),
                HttpResponse.BodyHandlers.ofString());

if (response.statusCode() == HttpURLConnection.HTTP_OK) {
    System.out.println(response.body());
}

服务端侧

像你提供的Spring Boot接口代码：

@GetMapping("/")
public String getHelloWorld() {
    return "Hello World!";
}

完全不需要修改！要支持HTTP/3，只需调整服务器配置：使用支持HTTP/3的服务器（如最新版Jetty、Undertow），并在配置中开启HTTP/3协议。以Spring Boot + Jetty为例，在application.properties中添加配置：

server.jetty.http3.enabled=true
server.port=443
server.ssl.enabled=true
# 补充你的SSL证书相关配置

为什么业务代码无需修改？ #

HTTP/3基于QUIC协议替代了HTTP/1.1、HTTP/2使用的TCP协议，但应用层的请求、响应格式与旧版本基本一致。业务逻辑完全感知不到底层传输协议的变化，只需让客户端和服务器的底层库完成HTTP/3的适配即可。

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