Spring Boot 2.6.13中OpenFeign 11.7/12.2的ResponseInterceptor替代实现

在OpenFeign 11.7及后续版本中，ResponseInterceptor已被移除，若要实现类似原aroundDecode的响应解码前后处理逻辑，推荐通过自定义Decoder来实现——核心思路是包装默认的Decoder，在解码前后插入自定义逻辑。

实现步骤 #

1. 自定义Decoder类，实现feign.Decoder接口，包装默认Decoder并添加处理逻辑
2. 将自定义Decoder配置到Feign客户端中

示例代码（Kotlin）

首先定义自定义Decoder：

import feign.Decoder
import feign.Response
import java.lang.reflect.Type

class MyResponseDecoder(private val delegate: Decoder) : Decoder {
    override fun decode(response: Response, type: Type): Any {
        // 解码前处理逻辑：比如读取响应状态、响应头、响应体内容等
        println("解码前捕获响应：状态码${response.status()}，响应头${response.headers()}")
        
        // 调用默认Decoder完成核心解码操作
        val decodedResult = delegate.decode(response, type)
        
        // 解码后处理逻辑：比如对返回结果做修改、校验、日志记录等
        println("解码后处理结果：$decodedResult")
        
        return decodedResult
    }
}

然后在Spring Boot环境中配置该Decoder：

• 方式一：针对单个FeignClient配置

import org.springframework.cloud.openfeign.FeignClient
import org.springframework.context.annotation.Bean

@FeignClient(
    name = "exampleClient",
    url = "https://api.example.com",
    configuration = [FeignClientConfig::class]
)
interface ExampleFeignClient {
    // 定义Feign接口方法
}

class FeignClientConfig {
    @Bean
    fun feignDecoder(defaultDecoder: Decoder): Decoder {
        return MyResponseDecoder(defaultDecoder)
    }
}

• 方式二：全局配置（所有FeignClient生效）

import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
import org.springframework.context.annotation.Primary

@Configuration
class GlobalFeignConfig {
    @Bean
    @Primary
    fun globalFeignDecoder(defaultDecoder: Decoder): Decoder {
        return MyResponseDecoder(defaultDecoder)
    }
}

补充说明 #

• 若需要针对特定方法做差异化处理，可以结合自定义InvocationHandlerFactory实现，但自定义Decoder是最直接的替代方案。
• 如果需要处理非2xx状态码的异常响应，可以搭配ErrorDecoder一起使用。

内容的提问来源于stack exchange，提问作者Jose Pacelli Oliveira