com.alibaba.cloud.sentinel.feign.SentinelContractHolder.parseAndValidateMetadata(Ljava/lang/Class;)L

升级至SpringCloud Alibaba 2.2.0.RELEASE后,出现与Feign和Sentinel兼容性问题,表现为AbstractMethodError。解决方案包括降级SpringCloud版本至Hoxton.SR1,自行修改SentinelContractHolder类,或等待SpringCloud Alibaba v2.2.1.RELEASE修复。

已搬家至简书:https://www.jianshu.com/p/731bb2cdab6e

背景

随着Spring Cloud Alibaba 2.2.0.RELEASE的发布,终于可以使用最新的Spring Boot和Spring Cloud。

现在的环境

依赖版本
Spring Boot2.2.5.RELEASE
Spring CloudHoxton.SR3
Spring Cloud Alibaba2.2.0.RELEASE

问题

已有工程升级了依赖版本之后,一启动就抛出以下错误:

Caused by: java.lang.AbstractMethodError: com.alibaba.cloud.sentinel.feign.SentinelContractHolder.parseAndValidateMetadata(Ljava/lang/Class;)Ljava/util/List;
	at feign.ReflectiveFeign$ParseHandlersByName.apply(ReflectiveFeign.java:151) ~[feign-core-10.7.4.jar:na]
	at feign.ReflectiveFeign.newInstance(ReflectiveFeign.java:49) ~[feign-core-10.7.4.jar:na]
	at feign.Feign$Builder.target(Feign.java:252) ~[feign-core-10.7.4.jar:na]
	at org.springframework.cloud.openfeign.HystrixTargeter.target(HystrixTargeter.java:38) ~[spring-cloud-openfeign-core-2.2.2.RELEASE.jar:2.2.2.RELEASE]
	at org.springframework.cloud.openfeign.FeignClientFactoryBean.loadBalance(FeignClientFactoryBean.java:253) ~[spring-cloud-openfeign-core-2.2.2.RELEASE.jar:2.2.2.RELEASE]
	at org.springframework.cloud.openfeign.FeignClientFactoryBean.getTarget(FeignClientFactoryBean.java:282) ~[spring-cloud-openfeign-core-2.2.2.RELEASE.jar:2.2.2.RELEASE]
	at org.springframework.cloud.openfeign.FeignClientFactoryBean.getObject(FeignClientFactoryBean.java:262) ~[spring-cloud-openfeign-core-2.2.2.RELEASE.jar:2.2.2.RELEASE]
	at org.springframework.beans.factory.support.FactoryBeanRegistrySupport.doGetObjectFromFactoryBean(FactoryBeanRegistrySupport.java:171) ~[spring-beans-5.2.4.RELEASE.jar:5.2.4.RELEASE]
	... 67 common frames omitted

解决

看了一下代码,问题的表现是从Sentinel抛出,本质是由于feign核心接口方法命名纠正拼写错误导致

Hoxton.SR1 中,fegin.context接口方法的定义为parseAndValidatateMetadata
Hoxton.SR3 中,fegin.context接口方法的定义为parseAndValidateMetadata

很明显是为了纠正拼写错误。

解决办法

  1. 将Spring Cloud Hoxton.SR3 降级为 Spring Cloud Hoxton.SR1
  2. 暂时自己修改SentinelContractHolder
  3. 暂时先不使用Hoxton,等Spring Cloud Alibaba v2.2.1.RELEASE发布之后再进行版本升级
    在这里插入图片描述

修改方法

  1. 在自己工程合适的地方,新建package:com.alibaba.cloud.sentinel.feign
  2. 拷贝com.alibaba.cloud.sentinel.feign.SentinelContractHolder至该目录
  3. 修改对应错误方法名

改后代码如下:

public class SentinelContractHolder implements Contract {

	private final Contract delegate;

	/**
	 * map key is constructed by ClassFullName + configKey. configKey is constructed by
	 * {@link feign.Feign#configKey}
	 */
	public final static Map<String, MethodMetadata> METADATA_MAP = new HashMap<>();

	public SentinelContractHolder(Contract delegate) {
		this.delegate = delegate;
	}

	@Override
	public List<MethodMetadata> parseAndValidateMetadata(Class<?> targetType) {
		List<MethodMetadata> metadatas = delegate.parseAndValidateMetadata(targetType);
		metadatas.forEach(metadata -> METADATA_MAP
				.put(targetType.getName() + metadata.configKey(), metadata));
		return metadatas;
	}
}

同步在Sentiel Github增加了说明:地址

个人首个开源项目:Spring Boot,Shiro,Redis,Ehcache,Thymeleaf,Postgresql的后台动态权限管理脚手架

### 解决 Java NoClassDefFoundError com.alibaba.csp.sentinel.util.SpiLoader 错误 当遇到 `java.lang.NoClassDefFoundError: com/alibaba/csp/sentinel/util/SpiLoader` 错误时,这通常意味着在运行时找不到指定的类文件。此类问题可能由多种原因引起,包括但不限于依赖冲突、版本不匹配或缺少必要的库。 #### 1. 检查 Sentinel Core 的版本兼容性 Sentinel-core 1.8.1 版本更改了 SpiLoader 类的位置至 `com.alibaba.csp.sentinel.spi` 路径下[^2]。因此如果项目中存在不同版本之间的混淆,则可能导致上述异常。建议确认当前使用的 sentinel-core 是否为最新稳定版,并调整 pom.xml 或 build.gradle 文件中的依赖声明来确保一致性: 对于 Maven 用户,在项目的 POM 文件内添加如下配置: ```xml <dependency> <groupId>com.alibaba.cloud</groupId> <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId> <version>${latest.version}</version><!-- 使用最新的版本号 --> </dependency> ``` #### 2. 清理 IDE 缓存并重新导入项目 有时开发环境(如 IDEA)内部缓存可能会导致加载错误。尝试通过清理IDE缓存解决问题[^4]: - 打开设置 -> 构建工具 -> Gradle/Maven 设置; - 取消勾选自动导入选项; - 关闭再打开工程让其强制刷新外部库; - 如果仍然存在问题可以考虑删除 .idea 和 target 目录后再试一次; #### 3. 验证 Classpath 中是否存在所需 JAR 包 确保 classpath 下确实包含了含有该 SPI 接口实现的 jar 包。可以通过命令行查看已引入的所有第三方库列表: Linux/macOS 系统执行: ```bash jar tf your-application.jar | grep csp/sentinel/spi/ ``` Windows 平台则可利用 PowerShell 完成相同操作: ```powershell Get-JarEntryInfo.ps1 -JarFile "your-application.jar" -Pattern "\csp\sentry\spi" ``` 以上方法可以帮助定位缺失的具体模块位置以便及时补充相应资源到构建路径当中去。 #### 4. 启用远程调试排查更深层次的原因 如果经过前面几步处理之后依旧无法彻底消除此异常现象的话,那么启用 JVM 参数支持远程调试功能不失为一种有效的手段来进行进一步分析[^3]: 目标机器端开启服务监听等待连接请求: ```shell nohup java \ -Xdebug \ -Xrunjdwp:transport=dt_socket,address=*:5005,server=y,suspend=n \ -jar application.jar & ``` 随后借助于本地集成开发环境中提供的 Remote Debug 功能建立会话链接,从而能够更加直观地观察程序实际执行流程以及变量状态变化情况找出根本症结所在。
评论 12
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

码匠君

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值