声明式调用：解密 Spring Cloud OpenFeign 拦截器与上下文传递原理

在微服务架构分布式集成中，我们通常需要跨服务传递一些全局的系统元数据，如用户身份令牌（Token）、链路追踪 ID（TraceId）等。当使用 Spring Cloud OpenFeign 进行服务间调用时，如何确保这些关键信息能安全、自动地附加到每一次远程 HTTP 请求头中？

OpenFeign 提供了核心拦截器组件 RequestInterceptor。但在生产环境中，一旦网关开启了 Hystrix 线程池隔离，或者业务引入了多线程异步调用，原本存在于当前线程 RequestContextHolder 中的上下文信息就会瞬间丢失，造成严重的权限缺失和链路断裂。

本文将系统拆解 RequestInterceptor 的拦截装配链路、多线程环境下上下文丢失的物理根源、以及基于 HystrixConcurrencyStrategy 的防线构建。

一、 核心生命周期：Feign 请求构造与拦截流转拓扑

每一次 Feign 声明式接口调用，其拦截注入的执行总线流向如下：

      [ 业务层发起 FeignClient RPC 调用 ]
                      │
                      ▼ 1. 构建 RequestTemplate (请求模板对象)
       [ SynchronousMethodHandler.execute() ]
                      │
                      ▼ 2. 依次遍历并回调 RequestInterceptor
     [ 核心接口: feign.RequestInterceptor ] ──> 执行 apply(template)
                      │
                      ├─ 3. 从内存上下文拉取全局元数据
                      ├─ 4. template.header("Authorization", token) 附加头部
                      │
                      ▼ 5. 由底层 Client（如 OkHttp）将 Template 转为真实 Request
         [ 网络 IO 广播 ──> 6. 下游微服务安全接收 Token ]

二、 Hystrix 线程池隔离下的 ThreadLocal 丢失机理

为什么开启线程池隔离后，Feign 拦截器就无法获取 RequestContextHolder 中的数据了？其技术根源在于 Java 的 ThreadLocal 特性：

三、 代码实战：实现跨线程 Hystrix 的 Feign 拦截器注入

以下代码展示了如何自定义 Hystrix 并发策略，将 Tomcat 容器线程的 RequestContext 跨线程克隆复制到 Hystrix 线程池中，保障 Feign 拦截器正常运行：

1. 自定义 Hystrix 并发策略（解决上下文跨线程丢失）

package com.company.infra.hystrix;

import com.alibaba.ttl.TransmittableThreadLocal;
import com.alibaba.ttl.threadpool.agent.TtlAgent;
import com.netflix.hystrix.strategy.concurrency.HystrixConcurrencyStrategy;
import org.springframework.stereotype.Component;
import org.springframework.web.context.request.*;
import java.util.concurrent.Callable;

@Component
public class HystrixRequestContextStrategy extends HystrixConcurrencyStrategy {

    @Override
    public <T> Callable<T> wrapCallable(Callable<T> callable) {
        // 1. 在 Tomcat 容器主线程提取当前的请求上下文
        RequestAttributes context = RequestContextHolder.getRequestAttributes();
        
        // 2. 包装并返回一个新的 Callable，在 Hystrix 线程被调度时，回填上下文
        return () -> {
            try {
                RequestContextHolder.setRequestAttributes(context);
                return callable.call();
            } finally {
                RequestContextHolder.resetRequestAttributes(); // 防止内存泄漏
            }
        };
    }
}

2. 编写 Feign 请求头拦截器

package com.company.infra.feign.interceptor;

import feign.*;
import org.springframework.stereotype.Component;
import org.springframework.web.context.request.*;
import javax.servlet.http.HttpServletRequest;

/**
 * 全局 Feign 请求拦截器：自动向所有 Feign RPC 调用透传 Authorization 头部
 */
@Component
public class FeignAuthRequestInterceptor implements RequestInterceptor {

    @Override
    public void apply(RequestTemplate template) {
        ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
        if (attributes != null) {
            HttpServletRequest request = attributes.getRequest();
            String token = request.getHeader("Authorization");
            
            // 往 Feign 模板中注入 Token 头部
            if (token != null) {
                template.header("Authorization", token);
            }
        }
    }
}

四、 总结

OpenFeign 的 RequestInterceptor 结合 Hystrix 跨线程穿透策略，是保障微服务分布式链路一致性的核心基石。

它通过**基于统一切面拦截的 RequestTemplate 修改，实现了全局凭证的零业务侵入透传；并依靠自定义 HystrixConcurrencyStrategy 控制器封装，平滑解决了多线程池物理隔离导致的 ThreadLocal 上下文断裂死穴**。掌握这套 Feign 拦截器装配与跨线程上下文传递技术，是打通全局链路追踪、构建高安全微服务鉴权架构的必修基本功！