Maven打包集成web3j时报org.web3j:core插件解析错误的解决方法
核心报错原因说明
你提到的
META-INF/maven/plugin.xml,是Maven插件JAR包内部的固定必需结构:所有合法Maven插件,都会在自身JAR包的根目录META-INF/maven/路径下存放插件描述文件,Maven加载插件时会强制读取该文件识别插件能力。这个路径位于你本地.m2仓库下载的第三方JAR包内部,你的项目源码目录没有这个文件夹是完全正常的。
你更换多个web3j版本都无法解决问题,是因为报错根源和web3j版本兼容性无关:
- Maven会将
<build><plugins>节点下配置的所有坐标识别为合法Maven插件,强制读取插件描述文件;但org.web3j:core本质是区块链工具类普通依赖,根本不是Maven插件,它的JAR包里不存在插件要求的plugin.xml文件,自然触发解析失败报错。 - 你额外将
spigot-api也配置成了Maven插件,同样会触发同类解析逻辑,进一步放大错误。 - 你对shade功能的使用完全混淆了概念:
shade是官方maven-shade-plugin插件的执行目标,不是web3j、spigot自带的能力,不能直接给web3j、spigot的坐标配置shade目标。
另外你当前的配置还存在两个隐藏问题:
- 给web3j core设置了
<scope>provided</scope>,就算插件错误修复完成,最终打包出的JAR也不会包含web3j的类,运行时会直接抛出类找不到的异常 - web3j 5.0.0版本要求Java 11及以上运行环境,如果你当前Spigot服务端运行在Java 8环境,哪怕打包成功也会触发版本兼容错误
可落地修复步骤
- 删除
<build><plugins>节点下所有错误配置的插件:即原配置里的org.web3j:core、org.spigotmc:spigot-api两个plugin块,这是触发报错的核心来源 - 修改web3j core依赖的作用域:直接删除依赖下的
<scope>provided</scope>标签,使用默认的编译作用域,确保依赖能被打包流程正常识别 - 如果你的Spigot服务端跑在Java 8环境,需要将web3j版本降级到4.9.8及以下兼容Java 8的版本;如果运行环境是Java 11+,可以保留web3j 5.0.0版本
- 引入官方Maven Shade插件,完成依赖打包进最终JAR的能力,参考配置如下:
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-shade-plugin</artifactId> <version>3.5.0</version> <executions> <execution> <phase>package</phase> <goals> <goal>shade</goal> </goals> <configuration> <!-- 重定位web3j类路径,避免和服务端其他插件的依赖版本冲突 --> <relocations> <relocation> <pattern>org.web3j</pattern> <shadedPattern>com.your.package.shaded.web3j</shadedPattern> </relocation> </relocations> <!-- 移除第三方JAR的签名文件,避免打包后Jar校验失败 --> <filters> <filter> <artifact>*:*</artifact> <excludes> <exclude>META-INF/*.SF</exclude> <exclude>META-INF/*.DSA</exclude> <exclude>META-INF/*.RSA</exclude> </excludes> </filter> </filters> </configuration> </execution> </executions> </plugin>
内容的提问来源于stack exchange,提问作者DIIMIIM
相关产品推荐
相关产品推荐

