OkHttp 2.7.5是否支持代理降级？版本升级后请求超时问题咨询

阿华AIGC实验室

2026-5-20

OkHttp 2.7.5 vs 3.10.0 代理 fallback 行为差异解答

你观察到的这个代理连接超时问题，确实是OkHttp从2.x升级到3.x版本时的预期行为变化，和两个版本的代理处理逻辑差异直接相关。

2.7.5版本的自动 fallback 逻辑

在OkHttp 2.x系列中，当通过系统属性-Dhttp.proxyHost和-Dhttp.proxyPort配置的代理无法连接时，客户端会自动触发 fallback 逻辑，直接绕过代理发起请求。这个设计当时是为了提升容错性，让请求在代理失效时仍能尝试直接连接，所以你在VPN环境下代理无效时仍能正常工作。

3.10.0版本的代理逻辑调整

OkHttp 3.x对代理选择机制做了更严谨的设计，默认情况下不会自动 fallback 到无代理连接，原因主要有两点：

尊重配置意图：如果用户明确配置了代理（不管是系统属性还是代码层面），OkHttp会认为你希望所有请求都通过该代理完成，不会擅自绕过代理发起请求。
安全考量：自动 fallback 可能导致敏感请求意外绕过代理，不符合一些企业场景的安全合规要求。

如何在3.10.0中恢复类似2.x的 fallback 行为

如果你需要在3.10.0中实现代理失效时自动切换到直接连接，可以通过自定义ProxySelector来实现，代码示例如下：

// 获取默认的代理选择器
ProxySelector defaultSelector = ProxySelector.getDefault();
// 自定义代理选择器，添加直接连接作为备选
ProxySelector customProxySelector = new ProxySelector() {
    @Override
    public List<Proxy> select(URI uri) {
        List<Proxy> proxies = defaultSelector.select(uri);
        // 添加无代理选项到列表末尾
        proxies.add(Proxy.NO_PROXY);
        return proxies;
    }

    @Override
    public void connectFailed(URI uri, SocketAddress sa, IOException ioe) {
        defaultSelector.connectFailed(uri, sa, ioe);
    }
};

// 构建OkHttpClient时设置自定义代理选择器
OkHttpClient client = new OkHttpClient.Builder()
        .proxySelector(customProxySelector)
        .build();

这段代码会让OkHttp在尝试代理连接失败后，自动尝试使用直接连接（Proxy.NO_PROXY）。

另外，你也可以结合重试拦截器，在连接超时后重新发起请求，进一步提升请求的容错性。