OkHttp客户端无法获取响应中自定义X-Algorithm、X-Signature头部

问题根因与解决方案 #

你遇到的自定义响应头在OkHttp拦截器中缺失的问题，90%以上的场景是客户端侧的拦截器顺序、封装层配置导致的，结合你给出的条件，具体排查方向如下：

可能的原因 #

• 拦截器注册顺序错误：签名校验拦截器被注册在其他拦截器之后，前置拦截器修改/删除了自定义响应头
• 上层封装组件过滤了自定义头：如果你使用了OpenFeign、RestTemplate等封装OkHttp的组件，默认配置可能会过滤非标准HTTP响应头
• OkHttp版本兼容问题：部分3.x旧版本的OkHttp存在响应头读取的bug，或错误配置了白名单规则过滤了自定义头
• 响应提前被消费：前置拦截器已经完全消费并关闭了响应流，导致后续拦截器无法读取完整响应头

解决步骤 #

1. 调整拦截器注册顺序
   将签名校验拦截器注册为OkHttp的第一个拦截器，确保拿到最原始的响应数据，排除其他拦截器的影响：

OkHttpClient client = new OkHttpClient.Builder()
    // 签名校验拦截器放在第一位
    .addInterceptor(new SignatureValidatorInterceptor(publicKey))
    // 其他业务拦截器放在后面
    .addInterceptor(otherBusinessInterceptor)
    .build();

2. 验证响应头真实存在性
   在拦截器中添加遍历所有响应头的日志，确认不是大小写匹配问题导致误判头缺失：

@Override
public Response intercept(final Interceptor.Chain chain) throws IOException {
    final Response response = chain.proceed(chain.request());
    final Headers headers = response.headers();
    // 新增遍历日志，确认所有头的key和值
    for (int i = 0; i < headers.size(); i++) {
        log.info("Header: {} = {}", headers.name(i), headers.value(i));
    }
    // 原有逻辑
}

3. 上层封装组件配置调整
   如果使用Spring Cloud OpenFeign封装OkHttp，添加以下配置，允许暴露自定义响应头：

# 启用OkHttp作为Feign的底层客户端
feign.okhttp.enabled=true
# 关闭默认的头过滤逻辑
feign.client.config.default.logger-level=FULL
feign.httpclient.disable-header-validation=false

4. 版本兼容验证
   如果你使用的是OkHttp 3.x旧版本，升级到4.10.x以上的稳定版，排除版本本身的bug影响。

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