Spring Cloud FeignClient编译报错：方法未标注HTTP方法类型

问题原因 #

你编写的FeignClient接口使用了Feign原生的@RequestLine和@Param注解，但Spring Cloud OpenFeign默认采用Spring MVC契约（SpringMvcContract），无法识别这些原生注解，因此抛出IllegalStateException: Method CurrencyClient#getByNameAndDate(String,LocalDateTime) not annotated with HTTP method type错误。

方案一：改用Spring MVC注解（推荐） #

替换Feign原生注解为Spring MVC标准注解，这是Spring Cloud Feign的默认适配方式：

@FeignClient(name = "currencyClient", url = "https://example", configuration = FeignConfig.class)
public interface CurrencyClient {
    @GetMapping("/{name}/{date}")
    @Headers("Content-Type: application/json")
    Currency getByNameAndDate(@PathVariable String name, @PathVariable LocalDateTime date);
}

• 用@GetMapping替代@RequestLine，明确指定HTTP请求方法与路径
• 用@PathVariable替代@Param，用于绑定URL路径中的参数
• 其他场景可继续使用Spring MVC对应注解（如@RequestHeader、@RequestBody等）

方案二：配置Feign原生契约 #

若需保留Feign原生注解，需在FeignConfig配置类中指定使用Feign原生契约：

import feign.Contract;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class FeignConfig {
    @Bean
    public Contract feignContract() {
        // 启用Feign原生契约，支持@RequestLine、@Param等注解
        return new feign.Contract.Default();
    }
}

配置完成后，原接口代码无需修改即可正常编译运行。

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