OpenFeign 的 RequestInterceptor 默认无法直接获取方法注解，需通过自定义 Contract 解析注解并存入 MethodMetadata，再由 RequestInterceptor 读取该元数据注入动态 Header。
OpenFeign 的 RequestInterceptor 默认无法直接获取被调用接口方法的元信息（如注解），因为它运行在代理调用链路中，不持有方法反射对象。但可以通过 Feign 的扩展机制（如 Contract 或自定义 MethodMetadata）配合 RequestInterceptor 间接实现「按方法注解注入 Header」的需求。
利用 Feign 的 MethodMetadata 存储注解信息
Feign 在解析接口时会将每个方法的注解、参数等信息封装为 MethodMetadata，并存入 Target 对应的缓存中。我们可以在拦截器中通过 feign.RequestTemplate 的 attributes（或结合 InvocationContext）传递方法级元数据。
- 推荐方式：在自定义
Contract中提前解析目标方法上的注解（如@HeaderParam或自定义注解），并将关键信息（如 header 名/值表达式）写入MethodMetadata的metadata字段（即Map） - 示例注解：
@interface HeaderParam { String name(); String value(); } - 在
Contract的parseAndValidateMetadata方法中遍历method.getAnnotations()，提取所需 header 配置，并存入methodMetadata.put("headerParams", headerList)
RequestInterceptor 中读取并注入 Header
拦截器本身不直接持有 Method 对象，但 RequestTemplate 在构建过程中会携带 MethodMetadata 的引用（可通过 template.methodMetadata() 获取，前提是 Contract 正确设置）。因此拦截器可从中提取预存的 header 信息：
- 重写
apply(RequestTemplate template) - 调用
template.methodMetadata()获取元数据（注意：需确保 Contract 已注入该字段，否则为 null） - 从
methodMetadata.get("headerParams")取出配置，再结合当前请求上下文（如 Spring 的RequestContextHolder）解析动态值（如 token、traceId） - 调用
template.header("X-User-ID", userId)注入
替代方案：使用 Spring Cloud OpenFeign 的 @Headers（静态场景）
如果 header 值是静态或基于 Spring EL 表达式的（如 @Headers("X-Tenant-ID: ${tenant.id}")），可直接在接口方法或类型上使用 @Headers 注解，无需自定义拦截器 —— OpenFeign 默认支持该注解解析。
- 适用于固定值或简单占位符，不支持运行时动态计算（如从 ThreadLocal 或 SecurityContext 读取）
- 若需动态值，仍需搭配
RequestInterceptor+ 自定义注解 + Contract 扩展
完整流程关键点提醒
整个链路依赖 Contract 和 Interceptor 协同工作，容易遗漏的细节：
- 自定义
Contract必须继承SpringMvcContract（或Default），并在构造时传入原始 contract，避免丢失默认解析逻辑 -
RequestInterceptorbean 需注册为@Bean，且不能是静态方法，否则无法注入 Spring 上下文（如ApplicationContext） - 动态 header 值建议封装为工具类（如
HeaderResolver），由拦截器调用，便于测试和复用 - 注意线程安全：
RequestTemplate是每次请求新建的，MethodMetadata是共享只读的，无需同步
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
