使用Java OkHttp3实现HTTP/2远程服务器可用性检查相关咨询

1. 证书相关说明 #

OkHttp3默认遵循标准TLS校验规则，HTTP/2协议绝大多数场景基于TLS层部署（协议标识为h2，仅少数内网场景使用明文h2c），证书相关规则如下：

• 公网生产环境：使用公共CA签发的有效证书时，无需额外配置，OkHttp3会自动走系统/JDK默认信任链完成校验
• 测试/私有环境：如果使用自签名证书，可选择将根证书导入JDK信任库完成合法校验，也可自定义X509TrustManager跳过证书校验。注意：跳过证书校验仅可用于测试环境，生产环境启用会存在中间人攻击风险
• 域名匹配校验：OkHttp3默认校验证书域名与请求域名的一致性，若测试环境存在域名不匹配的情况，可自定义HostnameVerifier临时放行，生产环境需保证证书域名与访问域名完全匹配

2. 凭证使用的必要性说明 #

凭证是否需要使用完全取决于目标服务器的访问控制规则：

• 若目标检测接口为公开无权限限制的资源，无需携带任何凭证即可完成检测
• 若服务器开启了应用层身份校验（如Basic Auth、Bearer Token），需在请求头携带对应凭证，否则会返回401/403状态码，无法正常完成可用性判断
• 若服务器开启了双向TLS认证（mTLS），必须在客户端配置合法的客户端证书，否则TLS握手阶段会直接失败，无法建立连接
  所有凭证配置仅在服务器开启对应访问控制时为必填项，无访问控制的场景无需配置

3. 可用示例代码 #

3.1 依赖引入（Maven） #

<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.10.0</version>
</dependency>

3.2 完整检测代码 #

import okhttp3.*;
import javax.net.ssl.*;
import java.security.cert.X509Certificate;

public class Http2AvailabilityChecker {
    // 生产环境删除此方法，使用默认证书校验即可
    private static OkHttpClient getUnsafeOkHttpClient() {
        try {
            TrustManager[] trustAllCerts = 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[]{};
                    }
                }
            };
            SSLContext sslContext = SSLContext.getInstance("TLS");
            sslContext.init(null, trustAllCerts, new java.security.SecureRandom());
            SSLSocketFactory sslSocketFactory = sslContext.getSocketFactory();

            return new OkHttpClient.Builder()
                    .sslSocketFactory(sslSocketFactory, (X509TrustManager) trustAllCerts[0])
                    // 生产环境删除此行，使用默认域名校验
                    .hostnameVerifier((hostname, session) -> true)
                    // 配置优先使用HTTP/2
                    .connectionSpecs(ConnectionSpec.MODERN_TLS)
                    .build();
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }

    public static boolean checkHttp2ServerAvailability(String url) {
        // 生产环境替换为 new OkHttpClient.Builder().connectionSpecs(ConnectionSpec.MODERN_TLS).build()
        OkHttpClient client = getUnsafeOkHttpClient();
        // 用HEAD请求降低检测开销，也可根据需求替换为GET
        Request request = new Request.Builder()
                .url(url)
                .head()
                .build();
        try (Response response = client.newCall(request).execute()) {
            // 校验两点：1. 响应状态正常 2. 协议为HTTP/2
            return response.isSuccessful() && response.protocol() == Protocol.HTTP_2;
        } catch (Exception e) {
            // 连接失败、握手失败均判定为不可用
            return false;
        }
    }

    public static void main(String[] args) {
        // 测试示例，替换为目标服务器地址
        String targetUrl = "https://your-server-url.com";
        boolean isAvailable = checkHttp2ServerAvailability(targetUrl);
        System.out.println("服务器HTTP/2可用性：" + isAvailable);
    }
}

OkHttp3替代方案推荐 #

• Apache HttpClient 5：Apache官方出品，原生支持HTTP/2，API规范、稳定性高，适合熟悉Apache技术栈的场景使用
• JDK 11+ 原生HttpClient：JDK内置组件，无需引入第三方依赖，原生支持HTTP/2同步/异步调用，适合轻量检测场景
• Netty：异步IO性能极强，适合高并发批量检测的场景，自定义程度高，但开发成本相对更高

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