如何判断Jar包是否自包含及解决运行时资源与依赖问题

一、如何判断Jar包是否为自包含？ #

从三个维度直接判断：

1. 查看Manifest清单：如果清单文件里的Class-Path字段列出了外部Jar包，说明当前Jar依赖外部类库，不是自包含。你的清单明确标注了Class-Path: vendor-1.0.0-jdk16.jar helper-library-1.0.0.jar，依赖这两个外部Jar。
2. 解压Jar检查内容：用jar xf myproject.jar解压后，查看是否包含自身项目的.class文件（比如com/mydomain/myproject/Main.class）和所有依赖的第三方类文件。你的目录结构显示.class文件在外部classes目录下，说明当前Jar未包含自身类，运行时必须依赖外部目录，显然不是自包含。
3. 运行报错特征：如果运行时需要外部classes目录才能找到主类（报ClassNotFoundException），或者依赖外部Vendor.lic、第三方Jar，那肯定不是自包含。

二、Vendor.lic是否应包含在最终Jar内？ #

必须包含。你的主类通过Main.class.getClassLoader().getResourceAsStream("Vendor.lic")加载许可证，这个方法是从类路径读取资源。把Vendor.lic打包进Jar的类路径根目录后，类加载器可直接读取，无需依赖外部文件，避免“Missing Vendor license resource”错误。

三、将Jar做成自包含可独立运行包的具体步骤 #

结合你的Maven配置，做以下修改即可实现：

1. 配置许可证文件的打包路径 #

在项目根目录新建src/main/resources目录，将Vendor.lic放入该目录。Maven会自动将此目录下的文件打包到Jar的类路径根目录，确保主类能读取到。

2. 修改Maven插件，打包成Fat Jar #

替换原有的maven-jar-plugin和maven-dependency-plugin配置，使用maven-shade-plugin将自身类、所有依赖Jar合并为一个可执行Jar：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-shade-plugin</artifactId>
      <version>3.4.1</version>
      <executions>
        <execution>
          <phase>package</phase>
          <goals>
            <goal>shade</goal>
          </goals>
          <configuration>
            <transformers>
              <!-- 指定正确的主类路径 -->
              <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                <mainClass>com.mydomain.myproject.Main</mainClass>
              </transformer>
              <!-- 处理资源冲突（如第三方Jar的服务配置） -->
              <transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
                <resource>META-INF/services/javax.annotation.processing.Processor</resource>
              </transformer>
            </transformers>
            <!-- 过滤签名文件，避免打包冲突 -->
            <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>
    <!-- 确保编译版本与运行环境匹配 -->
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.11.0</version>
      <configuration>
        <source>12</source>
        <target>12</target>
      </configuration>
    </plugin>
  </plugins>
</build>

说明：

• maven-shade-plugin会自动合并自身类、第三方依赖Jar到一个Jar中，生成的Jar无需外部依赖即可运行。
• 修正了主类路径不一致问题：你的清单原主类路径com.domain.project.Main与实际类路径com/mydomain/myproject/Main.class不匹配，需在配置中填写正确路径。

3. 构建并验证 #

执行mvn clean package，构建完成后target目录下会生成命名为myproject-1.0.0.jar的Fat Jar。验证方式：

• 解压Jar，检查是否包含com/mydomain/myproject/Main.class、Vendor.lic及第三方类文件。
• 直接运行：java -jar target/myproject-1.0.0.jar --parameter1 value --parameter2 value，此时无需外部classes目录、Vendor.lic和第三方Jar，可独立运行。

四、额外注意事项 #

• 确保src/main/resources/Vendor.lic为有效许可证，否则会触发“Invalid Vendor license”错误。
• 保持编译版本（pom中source/target=12）与运行环境Java 12.0.1一致，避免版本兼容问题。

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