Spring Cloud OpenFeign实战之 FeignException 405

本文解析了Feign在发起service to service调用时,原本定义为GET请求被错误转换为POST请求的问题。深入探讨了OpenFeign构造请求的机制,并提供了正确的参数注解使用方法,以解决此异常。

异常描述

feign.FeignException: status 405 reading UserFeignClient#get0(User); content:

{"timestamp":1482676142940,"status":405,"error":"Method Not Allowed", "exception":"org.springframework.web.HttpRequestMethodNotSupportedException","message":"Request method 'POST' not supported","path":"/user"}

FeignClient定义

@FeignClient("microservice-provider-user")

public interface UserFeignClient {

  @RequestMapping(value = "/user", method = RequestMethod.GET)

  public User get0(Long userId);

}

解决方法

明明定义的是GET请求,结果在发起service to service call时,被转换成了POST请求。原因是OpenFeign在构造请求时需要足够多的@RequestMapping/@RequestParam/@PathVariable/@RequestHeader等来构造http请求。通过阅读自己定义的FeignClient可以发现,GET请求中的参数定义缺少注解@RequestParam,故而报错。 将参数userId明确定义为@RequestParam("userId") Long userId

关注公众号交流学习

关注Java分布式架构实战, 持续精进

关注Java分布式架构实战, 持续精进

联系我,学习交流

联系我,学习交流

<think>嗯,用户遇到了Spring Cloud OpenFeign 3.0.6和Feign-Core 10.12的版本冲突问题,导致Contract.parseAndValidateMetadata方法找不到。我需要结合用户提供的引用信息和之前的回答来给出解决方案。 首先,用户之前提到的引用1中提到,版本错误会导致依赖问题,需要正确指定版本。而引用2和3展示了他们的pom.xml中的依赖配置,可能存在问题。之前我的回答已经建议通过Maven的依赖树检查冲突,并排除旧版本,或者强制指定版本。但现在用户可能尝试过这些方法但仍有问题,需要更详细的步骤。 用户现在明确需要解决的是版本兼容性问题,特别是OpenFeign 3.0.6和Feign-Core 10.12之间的冲突。根据之前的分析,Spring Cloud 2020.0.x默认使用Feign 11.0,所以用户环境中可能存在其他依赖引入了Feign-Core 10.12。需要检查依赖树,排除旧版本,并确保Spring Cloud BOM正确管理版本。 另外,用户可能在pom.xml中没有正确导入Spring Cloud的BOM,导致版本管理失效。需要确认dependencyManagement部分是否正确设置。同时,用户提到的引用1中他们手动指定版本可能无效,可能是因为BOM未被正确导入,或者有其他依赖覆盖了版本。 还需要考虑用户是否使用了其他库如feign-form,这些库可能传递依赖旧版本的Feign-Core,这时候需要排除这些传递依赖。同时,用户可能需要升级相关依赖如feign-form到兼容Feign 11.0的版本。 最后,用户可能需要强制指定Feign版本为11.0,并在pom.xml中显式声明,确保所有模块使用统一版本。验证步骤包括运行依赖树检查,以及编写测试代码确认加载的Jar版本是否正确。</think>### 精准解决方案:Spring Cloud OpenFeign 3.0.6 与 Feign-Core 10.12 版本冲突修复 --- #### **1. 根本问题定位** 错误 `NoSuchMethodError: Contract.parseAndValidatateMetadata` 的根源是 **Feign-Core 版本不兼容**: - `spring-cloud-starter-openfeign 3.0.6` 属于 Spring Cloud 2020.0.x("Ilford" 系列),其 **默认依赖 Feign-Core 11.0+**; - 若项目中混用 `feign-core 10.12`(如手动引入或间接依赖),会导致加载旧版本类文件,而旧版本中 `parseAndValidatateMetadata` 方法尚未存在[^1]。 --- #### **2. 分步解决流程** ##### **(1) 确认 Spring Cloud BOM 版本对齐** 在 `pom.xml` 中添加 Spring Cloud 的依赖管理配置,**强制统一版本**: ```xml <dependencyManagement> <dependencies> <!-- Spring Cloud 2020.0.6 对应 OpenFeign 3.0.6 --> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-dependencies</artifactId> <version>2020.0.6</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> ``` 此配置确保所有 Spring Cloud 组件版本与 OpenFeign 3.0.6 兼容[^2]。 ##### **(2) 排除旧版本 Feign-Core** 检查项目中是否有 **直接或间接引入 Feign-Core 10.12 的依赖**(如 `feign-form`、`feign-okhttp`): ```xml <!-- 示例:排除 feign-form 中的旧版 Feign-Core --> <dependency> <groupId>io.github.openfeign.form</groupId> <artifactId>feign-form</artifactId> <version>3.8.0</version> <exclusions> <exclusion> <groupId>io.github.openfeign</groupId> <artifactId>feign-core</artifactId> </exclusion> </exclusions> </dependency> ``` ##### **(3) 显式声明 Feign 11.0** 在 `pom.xml` 的 `<properties>` 中强制指定 Feign 版本: ```xml <properties> <!-- Feign 11.0 是 Spring Cloud 2020.0.x 官方兼容版本 --> <feign.version>11.0</feign.version> </properties> <!-- 显式声明 feign-core --> <dependency> <groupId>io.github.openfeign</groupId> <artifactId>feign-core</artifactId> <version>${feign.version}</version> </dependency> ``` ##### **(4) 验证依赖树** 通过 Maven 命令检查实际生效的 Feign 版本: ```bash mvn dependency:tree -Dincludes=io.github.openfeign:feign-core ``` 期望输出: ``` [INFO] +- org.springframework.cloud:spring-cloud-starter-openfeign:jar:3.0.6 [INFO] | \- io.github.openfeign:feign-core:jar:11.0 ``` --- #### **3. 关键代码适配** 若自定义了 Feign 的 `Contract` 实现,需确保使用 **Feign 11.0+ 的 API**: ```java import feign.Contract; @Configuration public class FeignConfig { @Bean public Contract feignContract() { // Feign 11.0+ 的 Contract 默认支持 OpenAPI 注解 return new Contract.Default(); } } ``` --- #### **4. 常见问题排查** - **场景1:Spring Boot 版本不匹配** Spring Cloud 2020.0.x 需要 **Spring Boot 2.4.x**。检查 `spring-boot-starter-parent` 版本: ```xml <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.4.13</version> <!-- 兼容版本 --> </parent> ``` - **场景2:第三方库依赖冲突** 若使用 `feign-okhttp` 或 `feign-httpclient`,需同步升级至 **11.0 兼容版本**: ```xml <dependency> <groupId>io.github.openfeign</groupId> <artifactId>feign-okhttp</artifactId> <version>11.0</version> </dependency> ``` --- #### **5. 验证成功标志** - 启动应用时无 `NoSuchMethodError` 异常; - 通过代码打印 Feign-Core 版本: ```java public class FeignVersionCheck { public static void main(String[] args) { System.out.println("Feign-Core Version: " + Contract.class.getPackage().getImplementationVersion()); } } ``` 输出应为 `11.0`。 --- ### 相关问题 1. 如何解决 Spring Cloud 2021.x 与 Feign 12.x 的兼容性问题? 2. 使用 OpenFeign 时如何自定义编解码器? 3. Spring Cloud 版本与 Spring Boot 版本的对应关系是什么? [^1]: Feign GitHub Issue #1442 - parseAndValidateMetadata 方法变更说明 [^2]: Spring Cloud 2020.0.6 官方文档 - OpenFeign 版本管理策略
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值