Spring Boot 项目在 IDEA 中 Maven 打包 Jar 不报错：clean → install 完整指南

一、前置准备

1. 确认项目是 Maven 管理 ，根目录有 pom.xml
2. IDEA 已配置本地 Maven（File → Settings → Build, Execution → Build Tools → Maven）
3. 如需可执行 Jar （带主类、依赖），pom.xml 必须配置打包插件

1. 基础 pom 打包配置（普通 Jar / 可执行 Jar）

① 普通 Jar（仅项目代码，不含依赖）

默认无需额外插件，install 即可生成。

② 可执行 Jar（推荐，带主类 + 所有依赖，直接 java -jar 运行）

在 pom.xml → build/plugins 加入 maven-assembly-plugin：

xml

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-assembly-plugin</artifactId>
    <version>3.6.0</version>
    <executions>
        <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
                <goal>single</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <!-- 你的项目主启动类（全类名） -->
        <mainClass>com.xxx.Application</mainClass>
        <archive>
            <manifest>
                <mainClass>com.xxx.Application</mainClass>
            </manifest>
        </archive>
        <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
        </descriptorRefs>
    </configuration>
</plugin>

替换 com.xxx.Application 为你项目真实主类全路径。

---

二、方式 1：IDEA 图形界面一键执行

步骤

1.打开右侧 Maven 面板（找不到：View → Tool Windows → Maven）

2.展开当前项目 → 展开 Lifecycle

3.按顺序执行两个生命周期：

先双击 clean：清空旧编译文件、旧包

再双击 install：编译代码、执行测试、打包 Jar、安装到本地 Maven 仓库

快捷一键组合（推荐）

方案 A：Maven 组合命令（一步完成 clean + install）

1. 点击 Maven 面板顶部 ⚙️ 切换运行配置 / 直接点左上角 Maven 命令输入框

2. 输入命令： plaintext

   clean install

3. 点击运行按钮 ▶ ，一步执行 clean + install

方案 B：保存为快捷运行项（下次直接点）

1. 顶部导航栏 → Run → Edit Configurations
2. 左侧点击 + → 选择 Maven
3. 配置：
   • Name：自定义（如 打包 clean+install）
   • Working directory：选择项目根目录（自动识别）
   • Command line：填写 clean install
4. 保存，以后直接在顶部下拉框选中运行即可。

---

三、方式 2：IDEA 内置终端 / 系统命令行

1. IDEA 终端（底部 Terminal）

进入项目根目录 （和 pom.xml 同级），执行：

mvn clean install

2. 系统 CMD/PowerShell

同理进入项目根目录，执行上面命令。

---

四、Jar 包输出位置

打包成功后，Jar 文件默认在：

项目根目录/target/

• 普通包：项目名-版本.jar
• 带依赖可执行包：项目名-版本-jar-with-dependencies.jar

---

五、关键说明 & 避坑

1. clean 和 install 作用

• clean ：删除 target 目录，清除旧编译产物，防止旧代码干扰打包
• install ：执行流程 = compile → test → package → install
  • package：生成 Jar
  • install：把包安装到本地 Maven 仓库，供其他项目依赖

2. 常见报错解决

1. 编译报错、代码红 先在 IDEA 修复代码错误，再打包。

2. 测试用例失败导致打包终止 跳过测试打包（命令改为）：

   mvn clean install -DskipTests

3. java -jar 运行提示「没有主清单属性」 原因：没配置打包插件 / 主类写错。 解决：回到上文，正确配置 maven-assembly-plugin 并填写正确主类全类名。

4. 依赖下载失败 检查 Maven 镜像源（推荐阿里云镜像），刷新 Maven 项目。

3. 只打包不安装（仅生成 Jar，不放入本地仓库）

如果不需要安装到本地仓库，只用：

clean package

---

六、最简总结

1. 可执行 Jar 先在 pom.xml 配置打包插件 + 主类
2. 首选命令：mvn clean install -DskipTests（跳过测试，打包更快）
3. 产物统一在 target 目录下。