这个问题我之前帮团队排查过好几次，本质就是Maven依赖传递机制导致的版本冲突——运行时类路径里混入了不兼容的旧版本Jar，刚好你的插件需要调用的方法在旧版本里不存在。下面给你几个针对性的解决步骤：

1. 全局锁定依赖版本（最省心的方案） #

直接在你的插件项目的pom.xml里通过<dependencyManagement>强制指定冲突依赖的统一版本，让Maven优先使用你指定的兼容版本，覆盖所有传递过来的旧版本：

<dependencyManagement>
    <dependencies>
        <!-- 锁定plexus-utils为3.3.0，匹配你需要的setFilenameComparator方法 -->
        <dependency>
            <groupId>org.codehaus.plexus</groupId>
            <artifactId>plexus-utils</artifactId>
            <version>3.3.0</version>
        </dependency>
        <!-- 统一commons-io版本，避免其他潜在冲突 -->
        <dependency>
            <groupId>commons-io</groupId>
            <artifactId>commons-io</artifactId>
            <version>2.6</version>
        </dependency>
    </dependencies>
</dependencyManagement>

2. 精准排查并排除冲突依赖 #

如果不想全局锁定版本，可以先定位到底是哪个依赖引入了旧版本的plexus-utils，用这个命令精准筛选：

mvn dependency:tree -Dverbose -Dincludes=org.codehaus.plexus:plexus-utils

找到对应的依赖后，在你的插件pom.xml里给该依赖添加<exclusions>，把旧版本的plexus-utils排除掉：

<dependency>
    <groupId>[引入旧版本的依赖groupId]</groupId>
    <artifactId>[引入旧版本的依赖artifactId]</artifactId>
    <version>[对应版本号]</version>
    <exclusions>
        <exclusion>
            <groupId>org.codehaus.plexus</groupId>
            <artifactId>plexus-utils</artifactId>
        </exclusion>
    </exclusions>
</dependency>

同样的方法也适用于commons-io的版本冲突。

3. 检查插件的依赖范围设置 #

确保你的插件中对plexus-utils这类核心依赖的<scope>没有错误设置。如果是插件运行时必须用到的，不要设置为provided（除非你能确定Maven核心自带的版本完全兼容），保持默认的compile或者显式设置为runtime，这样依赖会被正确加入到插件的运行类路径中。

4. 针对Maven核心依赖冲突的特殊处理 #

有时候冲突是因为Maven核心本身携带了旧版本的plexus-utils，这时候你需要在使用插件的项目的pom.xml里，通过<pluginDependencies>给插件明确指定依赖版本，确保插件优先使用你需要的版本：

<build>
    <plugins>
        <plugin>
            <groupId>com.mycompany</groupId>
            <artifactId>spi2jars-maven-plugin</artifactId>
            <version>1.0-SNAPSHOT</version>
            <dependencies>
                <dependency>
                    <groupId>org.codehaus.plexus</groupId>
                    <artifactId>plexus-utils</artifactId>
                    <version>3.3.0</version>
                </dependency>
            </dependencies>
        </plugin>
    </plugins>
</build>

验证修复效果 #

修改完成后，先执行mvn clean install重新构建你的插件，然后再运行目标插件命令测试：

mvn com.mycompany:spi2jars-maven-plugin:1.0-SNAPSHOT:spi2jars

如果还有问题，再次用mvn dependency:tree确认依赖版本是否已经统一，或者加-X参数查看运行时类路径的加载情况，确认旧版本Jar是否还在被加载。

内容的提问来源于stack exchange，提问作者Rob Audenaerde