IntelliJ IDEA导出WAR包全指南

IntelliJ IDEA 导出 WAR 包指南

在 IntelliJ IDEA 中，将项目打包为 WAR 文件主要有以下几种方式，适用于不同的项目类型和构建工具。

特性	社区版 (Community Edition)	终极版 (Ultimate Edition)
费用	免费	付费
主要支持语言	Java, Kotlin, Groovy, Scala 等 JVM 语言	支持所有语言，包括 JavaScript, TypeScript, SQL, PHP, Python, Ruby 等
框架支持	基本的 Java SE 和 Android 开发	全面的企业级框架支持（Spring, Java EE, Hibernate 等）和前端框架（React, Angular, Vue.js）
数据库工具	无	内置数据库工具
应用服务器集成	无	支持（如 Tomcat, JBoss）
适用场景	个人开发者、学生、开源项目、标准 Java/Android 开发	企业级应用开发、Web 开发、需要框架和高级工具支持的专业开发者

方法一：使用 Maven 打包（推荐）

这是最标准、最常用的方法，适用于所有 Maven 项目。

确认项目配置
- 确保项目根目录下有 pom.xml文件。
- 在 pom.xml中，将 <packaging>标签的值设置为 war：
  复制代码
```
<packaging>war</packaging>
```

配置构建插件

在 pom.xml的 <build>部分配置 maven-war-plugin等插件，例如可以指定 WAR 包名称并忽略缺少 web.xml的警告（适用于 Servlet 3.0+ 项目）。

复制代码

<build>
    <finalName>your-app-name</finalName>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>3.3.2</version>
            <configuration>
                <failOnMissingWebXml>false</failOnMissingWebXml>
            </configuration>
        </plugin>
    </plugins>
</build>

执行打包命令

可以通过以下任一方式执行打包：
- Maven 工具栏 ：打开 IDEA 右侧的 Maven 工具窗口，展开项目的 Lifecycle，双击 clean，然后双击 package。
- 终端：在项目根目录下执行命令 mvn clean package。
获取 WAR 包

命令执行成功后，WAR 文件将生成在 target/your-app-name.war。

方法二：使用 Gradle 打包

对于 Gradle 项目，操作流程类似。

配置 build.gradle

应用 war插件并配置基本信息：

复制代码

plugins {
    id 'war'
}
war {
    archiveFileName = 'your-app-name.war'
}

执行打包

打开 Gradle 工具窗口，找到项目的 Tasks-> build组，双击 war任务。

方法三：使用 IDEA 的 Artifacts 功能

此方法不依赖构建工具，直接通过 IDEA 构建。

配置 Artifact
- 打开 File-> Project Structure(快捷键 Ctrl+Alt+Shift+S)。
- 选择 Artifacts-> +-> Web Application: Archive-> 选择对应的模块。
构建 WAR 包
- 在主菜单选择 Build-> Build Artifacts...。
- 选择刚才创建的 Artifact，点击 Build。

方法四：Spring Boot 项目打包

Spring Boot 默认打包为可执行 JAR，若需部署到外部 Servlet 容器，需打包为 WAR。

修改 pom.xml
- 设置 <packaging>war</packaging>。
- 排除内嵌的 Tomcat，并将其依赖范围设为 provided，以确保它不会与外部容器的依赖冲突。
  复制代码
```
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
</dependency>
```

修改启动类

使启动类继承 SpringBootServletInitializer并重写 configure方法，这是为了支持在外部的Servlet容器中启动应用。

复制代码

@SpringBootApplication
public class Application extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(Application.class);
    }
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

执行打包

使用 mvn clean package命令打包。

常见问题与技巧

WAR 包内容验证 ：可以使用 jar -tf your-app.war命令查看生成的 WAR 包内部结构是否正确。
格式化代码 ：在打包前，可以使用 IntelliJ IDEA 的代码格式化功能（Ctrl+Alt+L）来保持代码风格统一，这通过缩排引擎实现，可以调整空格数量、大括号位置等规则。
多环境配置 ：对于需要不同配置（如数据库连接）的开发、测试、生产环境，可以利用 Spring Boot 的 profiles功能或 Maven 的 profiles来管理多份配置文件，在打包时指定具体环境。

希望这份整理后的笔记对您有帮助！