在将传统单体应用重构为微服务架构时，常会遇到多个JAR包包含同名路径下的类文件，从而引发类加载冲突，表现为方法找不到或类重复定义等问题。本文介绍两种基于Maven Shade插件的实用解决策略。

解决方案一：路径重命名（避免类冲突）

通过修改冲突包中类的包路径，使其在最终打包后与主项目中的类路径不重复。使用maven-shade-plugin的relocations功能实现。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <relocations>
                    <relocation>
                        <pattern>com.example.util</pattern>
                        <shadedPattern>com.example.util.shaded</shadedPattern>
                    </relocation>
                </relocations>
            </configuration>
        </execution>
    </executions>
</plugin>

上述配置将所有位于com.example.util包下的类，重新映射至com.example.util.shaded，有效隔离了命名空间。

解决方案二：排除特定文件（精简依赖）

若某些类文件无需使用，可直接从目标JAR中移除，避免冲突。通过filters标签进行精确排除。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <filters>
                    <filter>
                        <artifact>com.target:dependency-artifact</artifact>
                        <excludes>
                            <exclude>com/target/module/ConflictingClass.class</exclude>
                            <exclude>utils/Helper*.class</exclude>
                        </excludes>
                    </filter>
                </filters>
            </configuration>
        </execution>
    </executions>
</plugin>

该方式适用于已知某些类不会被调用，或存在版本差异但不影响功能的情况，有助于减小最终构建产物体积。

选择建议：若冲突类需保留且仅需命名隔离，优先使用重命名；若部分类可安全剔除，则采用排除策略以提升性能和清晰度。