从多独立Maven模块构建Uber-Jar失败，求助正确实现方案

我太懂这种挫败感了——多模块Maven项目打包成单个Uber-Jar，看着官方文档一步步来却没达到预期，确实容易让人头大。咱们先抛开之前的文档，从你的场景（大多模块相互独立）出发，理清楚可行的解决方案。

先明确核心思路：用专门的打包模块聚合所有内容 #

不管用哪种插件，最清晰的方式都是创建一个独立的打包模块（比如命名为your-project-uber），让这个模块依赖所有你要打包进Uber-Jar的业务模块。这样既不会干扰其他模块的正常构建，也能精准控制哪些内容被包含。

方案一：继续用maven-assembly-plugin（适合简单合并场景） #

如果你的模块没有复杂的类冲突、资源重叠，assembly插件完全够用。只需要在打包模块的POM里做如下配置：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>your.group.id</groupId>
        <artifactId>your-parent-pom</artifactId>
        <version>your-version</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>your-project-uber</artifactId>

    <dependencies>
        <!-- 引入所有需要打包的业务模块 -->
        <dependency>
            <groupId>your.group.id</groupId>
            <artifactId>module-1</artifactId>
            <version>${project.version}</version>
        </dependency>
        <dependency>
            <groupId>your.group.id</groupId>
            <artifactId>module-2</artifactId>
            <version>${project.version}</version>
        </dependency>
        <!-- 其他模块依次添加 -->
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-assembly-plugin</artifactId>
                <version>3.6.0</version>
                <executions>
                    <execution>
                        <id>build-uber-jar</id>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                        <configuration>
                            <!-- 使用官方预定义的"jar-with-dependencies"描述符，自动合并所有依赖 -->
                            <descriptorRefs>
                                <descriptorRef>jar-with-dependencies</descriptorRef>
                            </descriptorRefs>
                            <!-- 如果需要可执行Jar，指定主类 -->
                            <archive>
                                <manifest>
                                    <mainClass>com.yourcompany.MainEntry</mainClass>
                                </manifest>
                            </archive>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

然后记得把这个打包模块添加到父POM的modules列表中，执行mvn clean package后，就能在打包模块的target目录下找到生成的Uber-Jar。

方案二：用maven-shade-plugin（推荐处理复杂场景） #

如果你的模块存在重复类、SPI配置文件（比如META-INF/services）或者需要依赖重定位，shade插件比assembly更靠谱——它能智能合并资源、解决冲突，甚至重命名依赖包避免后续冲突。

同样在打包模块的POM中配置：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>your.group.id</groupId>
        <artifactId>your-parent-pom</artifactId>
        <version>your-version</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>your-project-uber</artifactId>

    <dependencies>
        <!-- 同样引入所有需要打包的业务模块 -->
        <dependency>
            <groupId>your.group.id</groupId>
            <artifactId>module-1</artifactId>
            <version>${project.version}</version>
        </dependency>
        <!-- 其他模块... -->
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.5.1</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                        <configuration>
                            <transformers>
                                <!-- 合并SPI配置文件，避免实现类丢失 -->
                                <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                                <!-- 指定可执行Jar的主类 -->
                                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                    <mainClass>com.yourcompany.MainEntry</mainClass>
                                </transformer>
                                <!-- 合并Spring相关的配置文件（如果用到Spring） -->
                                <transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
                                    <resource>META-INF/spring.handlers</resource>
                                </transformer>
                                <transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
                                    <resource>META-INF/spring.schemas</resource>
                                </transformer>
                            </transformers>
                            <!-- 排除签名文件，避免打包后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>
        </plugins>
    </build>
</project>

常见问题排查 #

• 确保所有需要打包的模块都被打包模块以compile范围依赖（默认就是compile，不用额外指定），这样才会被纳入Uber-Jar。
• 检查父POM的modules列表，确认打包模块被包含，否则构建时不会处理它。
• 执行mvn clean package -X查看详细日志，排查是否有模块未被正确引入、资源合并失败等警告或错误。
• 如果模块是完全独立的，没有互相依赖，打包模块只需要把它们逐个引入即可，插件会自动合并所有类和依赖。

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