Maven构建SpringBoot Jar时，如何控制classpath.idx中依赖的加载顺序？

方案1：排除坏Jar中的冲突类包 #

既然「坏」Jar违规包含了「好」Jar里的同包旧类，最直接的办法是从引入「坏」Jar的顶层依赖中排除冲突包，彻底避免重复类被打包。
在pom.xml中找到引入「坏」Jar的顶层依赖，添加<exclusions>标签排除冲突内容：

<dependency>
    <groupId>顶层依赖的groupId</groupId>
    <artifactId>顶层依赖的artifactId</artifactId>
    <version>xxx</version>
    <exclusions>
        <!-- 排除坏Jar中内嵌的好Jar对应包（替换为实际的groupId/artifactId） -->
        <exclusion>
            <groupId>好Jar的groupId</groupId>
            <artifactId>好Jar的artifactId</artifactId>
        </exclusion>
        <!-- 如果坏Jar直接内嵌了冲突类，排除具体包路径 -->
        <exclusion>
            <groupId>*</groupId>
            <artifactId>*</artifactId>
            <exclusion>
                <groupId>冲突类所在的包前缀</groupId>
                <artifactId>*</artifactId>
            </exclusion>
        </exclusion>
    </exclusions>
</dependency>

此方法从根源消除重复类，无需再纠结加载顺序。

方案2：将「好」Jar声明为直接依赖 #

Maven构建时，直接依赖的优先级高于传递依赖，会在fat jar的BOOT-INF/lib目录中排在更靠前的位置，确保类加载时优先加载「好」Jar中的类。
直接在pom.xml中添加「好」Jar的依赖声明：

<dependency>
    <groupId>好Jar的groupId</groupId>
    <artifactId>好Jar的artifactId</artifactId>
    <!-- 无需指定版本，Maven会自动继承传递依赖的版本，避免硬编码 -->
</dependency>

即使它原本是传递依赖，直接声明后会被视为直接依赖，依赖排序优先级提升，从而在lib目录中排在「坏」Jar之前。

方案3：用依赖管理锁定「好」Jar版本并提升优先级 #

通过dependencyManagement锁定「好」Jar的版本，同时配合直接依赖声明强化优先级：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>好Jar的groupId</groupId>
            <artifactId>好Jar的artifactId</artifactId>
            <version>目标版本号</version>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>好Jar的groupId</groupId>
        <artifactId>好Jar的artifactId</artifactId>
    </dependency>
</dependencies>

既锁定了稳定版本，又确保「好」Jar在依赖解析时被优先选择，避免传递依赖版本波动带来的问题。

补充：依赖顺序差异的排查方向 #

不同服务依赖顺序不同，通常源于：

• 顶层依赖的声明顺序差异，Maven依赖解析会受此影响
• 部分服务通过dependencyManagement锁定了Jar版本，改变了依赖解析路径
• 传递依赖的路径长度不同，Maven会优先选择路径更短的依赖

可以用mvn dependency:tree命令输出依赖树，对比正常服务和异常服务的依赖解析路径，定位差异点。

内容的提问来源于stack exchange，提问作者David M. Karr