You need to enable JavaScript to run this app. Maven打包集成web3j时报org.web3j:core插件解析错误的解决方法
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 21:15:04