Spring Feign Client请求Gzip压缩接口遇JSON解析异常求助

你已经正确告诉服务器你接受gzip压缩的响应，但漏了关键一步：让Feign客户端自动解压缩返回的gzip内容。错误里提到的CTRL-CHAR, code 31是gzip压缩数据的起始标记，说明Jackson正在尝试直接解析原始的二进制压缩数据，而非解压后的JSON，这自然会触发解析错误。

快速解决方案：启用Feign的响应压缩支持 #

如果你使用的是Spring Cloud OpenFeign，有两种简洁的方式解决这个问题：

方式1：通过配置文件（推荐）

在application.yml或application.properties中添加以下配置，Feign会自动处理请求头添加和响应解压缩：

feign:
  compression:
    request:
      enabled: true
      mime-types: application/json
      min-request-size: 2048 # 可选：仅当请求大小超过该值时才压缩请求
    response:
      enabled: true # 核心配置：开启响应自动解压缩

配置后，你甚至可以删掉手动写的GzipFeignRequestInterceptor，Feign会自动为请求添加Accept-Encoding: gzip头。

方式2：通过Java代码自定义解码器

如果你更倾向于代码层面控制，可以修改你的ClientConfig，添加支持gzip解压缩的Decoder：

class ClientConfig {
    @Bean
    fun feignDecoder(): Decoder {
        // 用JacksonDecoder作为基础解码器，包装成支持gzip解压缩的Decoder
        val jacksonDecoder = JacksonDecoder()
        return GzipDecoder(jacksonDecoder)
    }

    // 若需要手动控制请求头，可保留该拦截器；用配置文件的话可以删除
    @Bean
    fun gzipFeignRequestInterceptor(): RequestInterceptor {
        return GzipFeignRequestInterceptor()
    }

    class GzipFeignRequestInterceptor : RequestInterceptor {
        override fun apply(template: RequestTemplate) {
            template.header("Accept-Encoding", "gzip")
        }
    }
}

为什么浏览器能正常工作？ #

浏览器在发送请求时会自动添加Accept-Encoding: gzip头，并且收到压缩响应后会自动完成解压缩，再将明文JSON交给JS解析。而Feign默认没有开启这个自动解压缩逻辑，所以需要我们手动配置。

验证修改 #

完成配置后调用data()方法，Feign会先将服务器返回的gzip二进制数据解压缩为明文JSON，再交给Jackson解析，就能避免你遇到的JSON解析错误了。

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