Spring Boot调用HTTP/2 API失败：无法发起HTTP/2 POST请求求助

核心问题 #

1. server.http2.enabled=true是配置你的Spring Boot应用作为HTTP/2服务端，和你作为客户端调用外部API完全无关，这个配置无效。
2. JDK自带的HttpClient默认不支持明文HTTP/2（h2c协议），如果目标API是http://开头的明文地址，需要手动开启h2c支持；如果目标API仅支持HTTPS下的HTTP/2，则必须使用https://开头的URL。
3. 错误堆栈里的HTTP/1.1 header parser received no bytes说明客户端尝试用HTTP/1.1解析响应，但连接提前断开，本质是HTTP/2协商失败。

具体修复步骤 #

1. 针对明文HTTP/2（h2c）的API #

修改HttpClient的创建逻辑，添加h2c协议支持：

public static HttpClient newHttpClient() {
    return HttpClient.newBuilder()
            .version(HttpClient.Version.HTTP_2)
            .protocols(List.of(Protocol.H2C, Protocol.HTTP_1_1)) // 启用h2c和HTTP/1.1降级
            .build();
}

2. 针对HTTPS下的HTTP/2（h2）的API #

• 将请求URL替换为https://开头的地址
• 确保目标服务的SSL证书被JVM信任（如果是自签证书，可临时禁用证书校验仅用于测试）：

// 仅测试环境使用，生产环境禁止此操作
public static HttpClient newHttpClient() throws NoSuchAlgorithmException, KeyManagementException {
    SSLContext sslContext = SSLContext.getInstance("TLS");
    sslContext.init(null, new TrustManager[]{new X509TrustManager() {
        @Override
        public void checkClientTrusted(X509Certificate[] chain, String authType) {}
        @Override
        public void checkServerTrusted(X509Certificate[] chain, String authType) {}
        @Override
        public X509Certificate[] getAcceptedIssuers() {return new X509Certificate[0];}
    }}, new SecureRandom());
    
    return HttpClient.newBuilder()
            .version(HttpClient.Version.HTTP_2)
            .sslContext(sslContext)
            .build();
}

3. 额外检查项 #

• 验证目标API是否真的支持HTTP/2：用curl测试

# 明文地址测试
curl -v --http2 http://192.XXX.0.XXX:XXX/XXX/v1/XXX
# HTTPS地址测试
curl -v --http2 https://192.XXX.0.XXX:XXX/XXX/v1/XXX

• 修正文件路径转义错误：Java字符串里的\需转义为\\，或改用/：

new File("C:\\Users\\XXX\\Desktop\\test.json").toPath()
// 或者
new File("C:/Users/XXX/Desktop/test.json").toPath()

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