如何为Maven配置classpath以生成依赖外置的可执行Jar包

问题根因 #

你使用的maven-jar-plugin 2.4版本存在已知bug，当依赖版本号包含特殊后缀（如你引入的joda-time版本号带时间戳后缀-201110292322）时，会无法正常生成Class-Path属性到MANIFEST文件中。

修复方案 #

直接升级maven-jar-plugin到3.x以上的稳定版本即可，建议同时升级maven-dependency-plugin版本避免其他兼容问题，修改后的插件配置如下：

<plugins>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-dependency-plugin</artifactId>
        <!-- 升级到稳定新版本 -->
        <version>3.6.0</version>
        <executions>
            <execution>
                <id>copy-dependencies</id>
                <phase>prepare-package</phase>
                <goals>
                    <goal>copy-dependencies</goal>
                </goals>
                <configuration>
                    <outputDirectory>
                        ${project.build.directory}/lib
                    </outputDirectory>
                    <!-- 可选配置：如果需要去掉依赖的版本号，开启这个配置，同时maven-jar-plugin也要加<stripVersion>true</stripVersion> -->
                    <!-- <stripVersion>false</stripVersion> -->
                </configuration>
            </execution>
        </executions>
    </plugin>

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-jar-plugin</artifactId>
        <!-- 升级到稳定新版本，修复版本号识别bug -->
        <version>3.3.0</version>
        <configuration>
            <archive>
                <manifest>
                    <addClasspath>true</addClasspath>
                    <classpathPrefix>lib/</classpathPrefix>
                    <mainClass>org.sav.app.App</mainClass>
                    <!-- 如果上面dependency-plugin开了stripVersion，这里也要对应开启 -->
                    <!-- <stripVersion>false</stripVersion> -->
                </manifest>
            </archive>
        </configuration>
    </plugin>
</plugins>

验证步骤 #

1. 执行mvn clean install重新打包
2. 检查生成的Jar包内MANIFEST.MF文件，已经自动生成Class-Path属性
3. 将Jar包和lib目录放在同一级目录下，执行java -jar console-app-01-1.0-SNAPSHOT.jar即可正常运行

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