maven-jar-plugin

### 正确配置和使用 `maven-jar-plugin`

`maven-jar-plugin` 是用于创建标准 Java JAR 文件的 Maven 插件。此插件允许自定义生成的 JAR 文件中的元数据，特别是 MANIFEST.MF 文件的内容。

#### 配置 `pom.xml` 中的 `maven-jar-plugin`

为了确保能够正确地构建应用程序并包含必要的信息，在项目的 `pom.xml` 文件内添加如下所示的 `<build>` 节点：

<build>
    <plugins>
        <!-- 使用 maven-jar-plugin 来定制化 jar -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.2.0</version>
            <configuration>
                <archive>
                    <manifest>
                        <addClasspath>true</addClasspath>
                        <mainClass>com.example.MainApp</mainClass>
                    </manifest>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>

上述 XML 片段展示了如何设置 `maven-jar-plugin` 的版本号以及指定要写入到 JAR 清单 (MANIFEST.MF) 中的信息[^1]。这里设置了两个重要的属性:

- `addClasspath`: 如果设为 true，则会把编译期间所依赖的所有库路径加入 Class-Path 属性中。
- `mainClass`: 定义启动应用时默认执行哪个类里的 main 方法。

通过这种方式可以更灵活地控制最终产生的 JAR 文件结构及其行为特性。

#### 常见问题处理

当遇到无法正常运行打包后的程序等问题时，可能是因为缺少某些必要的配置项或是存在冲突的情况。此时可以通过调整 plugin 设置来解决问题。例如，如果希望将所有的依赖都嵌入到同一个可执行 JAR 文件里而不是依靠外部 classpath 加载它们，那么应该考虑采用其他更适合此类需求的方式如 `spring-boot-maven-plugin` 或者 `maven-shade-plugin` 这样的工具来进行打包操作[^2]。