前后端项目打包对比——关于Spring Boot Maven Plugin配置的问题

球球不吃虾2024-07-29 9:51

Spring Boot Maven Plugin 配置详解

    • [Spring Boot Maven Plugin 配置详解](#Spring Boot Maven Plugin 配置详解)
      • [1. 添加插件到 `pom.xml`](#1. 添加插件到 pom.xml)
      • [2. 插件配置](#2. 插件配置)
      • [3. 使用插件打包应用程序](#3. 使用插件打包应用程序)
        • [3.1 打包成 JAR 文件](#3.1 打包成 JAR 文件)
        • [3.2 打包成 WAR 文件](#3.2 打包成 WAR 文件)
      • [4. 运行 Spring Boot 应用程序](#4. 运行 Spring Boot 应用程序)
        • [4.1 使用 Maven 运行](#4.1 使用 Maven 运行)
        • [4.2 使用生成的 JAR 文件运行](#4.2 使用生成的 JAR 文件运行)
      • [5. 调试 Spring Boot 应用程序](#5. 调试 Spring Boot 应用程序)
        • [5.1 使用 Maven 调试](#5.1 使用 Maven 调试)
      • [6. 常见问题和解决方案](#6. 常见问题和解决方案)
        • [6.1 无法解析配置](#6.1 无法解析配置)
        • [6.2 应用程序无法启动](#6.2 应用程序无法启动)
        • [6.3 调试问题](#6.3 调试问题)

Spring Boot Maven Plugin 配置详解

Spring Boot Maven Plugin 是一个用于构建 Spring Boot 应用程序的 Maven 插件。它提供了多种功能，包括打包应用程序为可执行 JAR 或 WAR 文件，以及运行 Spring Boot 应用程序。以下是该插件的详细配置说明。

1. 添加插件到 pom.xml

首先，确保在项目的 pom.xml 文件中添加了 Spring Boot Maven Plugin：

xml 复制代码 
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>3.2.5</version> <!-- 确保版本与 Spring Boot 版本兼容 -->
        </plugin>
    </plugins>
</build>

2. 插件配置

2.1 基本配置

以下是插件的基本配置示例：

xml 复制代码 
<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <mainClass>com.example.Main</mainClass> <!-- 指定主类 -->
    </configuration>
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal> <!-- 重新打包 -->
            </goals>
            <configuration>
                <!-- 可以在这里覆盖或添加额外的配置 -->
            </configuration>
        </execution>
    </executions>
</plugin>
2.2 配置参数详解
  • mainClass：指定应用程序的主类，这是启动 Spring Boot 应用程序时需要的入口类。
  • layout ：指定打包布局。可选值有 JAR、WAR 和 NONE。默认值为 NONE。
    • JAR：生成一个包含所有依赖项的可执行 JAR 文件。
    • WAR：生成一个 WAR 文件，适用于部署到 Web 服务器。
    • NONE：不改变 Maven 默认的打包布局。
  • executable ：布尔值，指示是否生成可执行 JAR 文件。默认值为 false。
  • includes 和 excludes ：用于指定包含或排除的依赖项。可以指定 groupId 和 artifactId。
  • classifier：为生成的 JAR 文件添加分类器。这在生成多个不同配置的 JAR 文件时非常有用。
  • image：指定生成的 JAR 文件的名称。
  • requiresUnpack ：指定是否需要在运行时解压 JAR 文件。默认值为 true。

您是对的，对于 Spring Boot 项目来说，很多配置都是可选的，因为 Spring Boot Maven Plugin 提供了一些默认行为，使得在很多情况下，即使不进行额外配置也能正常打包和运行应用程序。

默认行为说明

  1. <packaging> 标签 ：在 Maven 中，<packaging> 标签定义了构建产物的类型。对于 Spring Boot 应用，通常使用 jar 作为打包类型。这是 Maven 项目的基本配置，并不是 Spring Boot Maven Plugin 的一部分。

  2. Spring Boot Maven Plugin：该插件的主要作用是处理 Spring Boot 应用的特定打包需求，比如嵌入依赖、生成可执行 JAR 等。以下是一些关键点：

    • 默认 layout ：如果不显式指定 layout 属性，插件会根据 <packaging> 标签的值来决定打包布局。对于 jar 类型，它默认使用 NONE，这意味着它会保留 Maven 的标准打包布局。
    • 默认 mainClass ：插件会尝试自动检测应用的主类。如果没有显式指定 mainClass 属性，它会查找带有 SpringBootApplication 注解的类。
    • 默认 excludes：Lombok 等一些依赖默认情况下会被排除在最终的 JAR 之外，因为它们在运行时不需要。
简单配置示例

以下是一个简单的 pom.xml 配置示例，它展示了如何使用 Spring Boot Maven Plugin 打包 Spring Boot 应用：

xml 复制代码 
<project>
    <!-- ... 其他配置 ... -->
    <packaging>jar</packaging>
    
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>3.2.5</version> <!-- 使用与 Spring Boot 版本相匹配的插件版本 -->
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>
为什么这样的配置能工作？
  • 自动检测：Spring Boot Maven Plugin 会自动检测并处理许多常见的配置，比如查找主类、嵌入依赖等。
  • Maven 的灵活性 ：Maven 本身在处理 jar 打包类型时已经提供了一套完整的机制，Spring Boot Maven Plugin 主要是在此基础上增加了对 Spring Boot 应用的支持。
进一步说明
  • <goal>repackage</goal> ：这个目标是 Spring Boot Maven Plugin 的一部分，用于重新打包应用，确保所有依赖都被正确嵌入到最终的 JAR 文件中。即使不显式指定这个目标，Maven 在执行 mvn package 时也会自动调用它。
  • <mainClass> ：虽然可以不指定，但显式指定 mainClass 可以提供更好的控制，特别是在有多个入口类的情况下。
2.3 高级配置

以下是一些高级配置示例：

xml 复制代码 
<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <mainClass>com.example.Main</mainClass>
        <layout>JAR</layout>
        <executable>true</executable>
        <classifier>exec</classifier>
        <image>myapp</image>
        <requiresUnpack>false</requiresUnpack>
        <includes>
            <include>
                <groupId>non-optional</groupId>
                <artifactId>non-optional</artifactId>
            </include>
        </includes>
        <excludes>
            <exclude>
                <groupId>optional</groupId>
                <artifactId>optional</artifactId>
            </exclude>
        </excludes>
    </configuration>
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal>
            </goals>
            <configuration>
                <!-- 可以在这里覆盖或添加额外的配置 -->
            </configuration>
        </execution>
    </executions>
</plugin>

3. 使用插件打包应用程序

3.1 打包成 JAR 文件

运行以下 Maven 命令将应用程序打包成 JAR 文件：

shell 复制代码 
mvn clean package

这将执行 spring-boot-maven-plugin 的 repackage 目标，生成一个包含所有依赖项的可执行 JAR 文件。

3.2 打包成 WAR 文件

如果需要将应用程序打包成 WAR 文件，可以在 pom.xml 文件中设置 layout 属性为 WAR：

xml 复制代码 
<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <mainClass>com.example.Main</mainClass>
        <layout>WAR</layout>
    </configuration>
</plugin>

然后运行以下命令：

shell 复制代码 
mvn clean package

这将生成一个 WAR 文件，可以部署到 Web 服务器。

4. 运行 Spring Boot 应用程序

4.1 使用 Maven 运行

Spring Boot Maven Plugin 允许你直接从命令行运行 Spring Boot 应用程序，而无需手动启动 JVM。要运行应用程序，可以使用以下命令：

shell 复制代码 
mvn spring-boot:run

这将启动应用程序，并在控制台中显示应用程序的输出。

4.2 使用生成的 JAR 文件运行

如果生成了可执行 JAR 文件，可以使用以下命令运行应用程序：

shell 复制代码 
java -jar target/myapp-0.0.1-SNAPSHOT.jar

这将启动应用程序，并在控制台中显示应用程序的输出。

5. 调试 Spring Boot 应用程序

5.1 使用 Maven 调试

要使用 Maven 调试 Spring Boot 应用程序，可以在 pom.xml 文件中添加以下配置：

xml 复制代码 
<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <jvmArguments>
            -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n
        </jvmArguments>
    </configuration>
</plugin>

然后运行以下命令：

shell 复制代码 
mvn spring-boot:run

这将启动应用程序，并在端口 8000 上监听调试连接。

6. 常见问题和解决方案

6.1 无法解析配置

如果遇到类似以下错误：

Failed to execute goal org.springframework.boot:spring-boot-maven-plugin:3.2.5:repackage (repackage) on project myapp: Unable to parse configuration of mojo org.springframework.boot:spring-boot-maven-plugin:3.2.5:repackage: Cannot convert 'PACKAGE_INTO_ONE_JAR' to Enum: No enum constant org.springframework.boot.maven.AbstractPackagerMojo.LayoutType.PACKAGE_INTO_ONE_JAR

这通常是因为 layout 属性的值不正确。确保 layout 属性的值是 JAR、WAR 或 NONE。

6.2 应用程序无法启动

如果应用程序无法启动，检查以下可能的原因：

  • 依赖项缺失 ：确保所有依赖项都已正确添加到 pom.xml 文件中。
  • 主类错误 ：检查 mainClass 属性是否正确指向应用程序的主类。
  • 配置文件错误 ：检查应用程序的配置文件（如 application.properties 或 application.yml）是否有错误。
6.3 调试问题

如果调试时遇到问题，检查以下可能的原因：

  • 调试参数错误 ：确保调试参数正确添加到 pom.xml 文件中。
  • IDE 配置：确保 IDE 正确配置了远程调试。

注意：本文的目的是提供一个详细的指南，但实际的配置和用法可能会根据你的具体项目需求和环境而有所不同。建议根据实际情况调整配置，并参考 Spring Boot 和 Maven 的官方文档获取更多信息。

相关推荐
Cachel wood5 分钟前
python round四舍五入和decimal库精确四舍五入
java·linux·前端·数据库·vue.js·python·前端框架
学代码的小前端7 分钟前
0基础学前端-----CSS DAY9
前端·css
gb421528711 分钟前
springboot中Jackson库和jsonpath库的区别和联系。
java·spring boot·后端
joan_8511 分钟前
layui表格templet图片渲染--模板字符串和字符串拼接
前端·javascript·layui
m0_7482361142 分钟前
Calcite Web 项目常见问题解决方案
开发语言·前端·rust
Watermelo6171 小时前
详解js柯里化原理及用法，探究柯里化在Redux Selector 的场景模拟、构建复杂的数据流管道、优化深度嵌套函数中的精妙应用
开发语言·前端·javascript·算法·数据挖掘·数据分析·ecmascript
m0_748248941 小时前
HTML5系列（11）-- Web 无障碍开发指南
前端·html·html5
m0_748235611 小时前
从零开始学前端之HTML（三）
前端·html
一个处女座的程序猿O(∩_∩)O3 小时前
小型 Vue 项目，该不该用 Pinia 、Vuex呢？
前端·javascript·vue.js
hackeroink6 小时前
【2024版】最新推荐好用的XSS漏洞扫描利用工具_xss扫描工具
前端·xss
热门推荐
01〔AI 绘画〕Stable Diffusion 之 解决绘制多人或面部很小的人物时面部崩坏问题 篇02ARM学习（31）编译器对overlay方式的支持03玄机平台应急响应—webshell查杀04DisplayPort AltMode On Type-c协议_Ver2.0(学习笔记)05校验 GPT-4 真实性的三个经典问题：快速区分 GPT-3.5 与 GPT-4，并提供免费测试网站06Docker 夺命连环 15 问076个主流的工业3D管道设计软件08基于大语言模型（LLM）的合成数据生成、策展和评估的综述09(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明10红米手机使用google play