如何在Feign JAX-RS的@Path中使用Spring属性占位符？

这是个挺典型的场景——当Feign结合JAX-RS契约使用时，Spring的属性占位符解析逻辑并不是对所有注解属性都生效的。你已经发现了，@FeignClient的url属性能正常解析${server.url}，但JAX-RS的@Path注解里的${server.querypath}却被当成字面量发送请求，这背后是Feign和Spring处理注解的分工差异导致的：

• @FeignClient的属性是由Spring Cloud Feign直接接管的，会自动触发Spring的占位符解析机制；
• 而@Path这类JAX-RS注解，默认是由Feign的JAXRSContract来处理，它本身并不支持Spring的属性占位符解析。

下面给你两种实用的解决方案：

方案一：用SpEL+@Value快速注入路径 #

在Feign接口里通过@Value注入占位符对应的路径值，然后在@Path里用Feign支持的SpEL表达式引用这个值：

@FeignClient(value = "myClient", url = "${server.url}", configuration = MyFeignConf.class)
public interface MyClient {

    // 用@Value注入解析后的路径
    @Value("${server.querypath}")
    String QUERY_PATH;

    @GET
    // 用SpEL引用接口类中的常量，TARGET_CLASS是Feign提供的内置变量，指向当前接口
    @Path("#{TARGET_CLASS.QUERY_PATH}")
    @Produces("application/json")
    JsonNode olaTvQuery(@QueryParam("nbResults") int nbResults);
}

这种方法简单直接，适合单个接口的场景，不用额外写配置类。

方案二：自定义Contract全局解析占位符 #

如果你的项目里有很多Feign接口都需要解析JAX-RS注解里的占位符，推荐自定义一个增强版的JAXRSContract，让它自动处理占位符：

1. 实现自定义Contract类 #

import feign.Contract;
import feign.jaxrs.JAXRSContract;
import org.springframework.context.Environment;
import org.springframework.util.StringUtils;

public class PlaceholderResolvingJaxrsContract extends JAXRSContract {

    private final Environment environment;

    public PlaceholderResolvingJaxrsContract(Environment environment) {
        this.environment = environment;
    }

    @Override
    protected void processAnnotationOnMethod(MethodMetadata data, Annotation methodAnnotation, Method method) {
        super.processAnnotationOnMethod(data, methodAnnotation, method);
        // 拦截@Path注解，解析其中的占位符
        if (methodAnnotation instanceof Path) {
            Path pathAnnotation = (Path) methodAnnotation;
            String rawPath = pathAnnotation.value();
            if (StringUtils.hasText(rawPath)) {
                // 用Spring的Environment解析占位符
                String resolvedPath = environment.resolvePlaceholders(rawPath);
                // 更新Feign的请求模板路径
                data.template().uri(resolvedPath, true);
            }
        }
    }
}

2. 在Feign配置类中注册这个Contract #

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.env.Environment;

@Configuration
public class MyFeignConf {

    @Bean
    public Contract feignContract(Environment environment) {
        return new PlaceholderResolvingJaxrsContract(environment);
    }
}

这样所有使用JAX-RS契约的Feign接口，@Path里的占位符都会被自动解析，一劳永逸。

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