IntelliJ IDEA 打包 Web 项目 WAR 包及 Tomcat 部署指南

四、打包与验证：确保 WAR 包可用

4.1 执行打包操作

1. 操作步骤：点击顶部菜单栏「Build」→「Build Artifacts」→在弹窗中选择已配置的 Artifact（如 unnamed:war）→选择「Build」（首次打包）或「Rebuild」（更新后重新打包）。
2. 查找 WAR 包：打包完成后，WAR 包默认存放在项目根目录下的 out\artifacts\ 文件夹中（如 demo\out\artifacts\unnamed.war）。

4.2 验证 WAR 包有效性（避免白忙活）

1. 验证方法：用压缩软件（如 WinRAR）打开 WAR 包，检查以下 3 点：
   • 根目录下是否有 index.html 等页面文件。
   • WEB-INF 文件夹下是否有 classes 目录，且 classes 内有 .class 文件。
   • WEB-INF 文件夹下是否有 web.xml（若项目用注解配置则可无，但传统项目需包含）。
2. 验证目的：提前排查打包缺陷，避免带着问题去部署，减少后续排错时间。

五、Tomcat 部署：从打包到访问全流程

1. 部署步骤：
   • 将验证通过的 WAR 包复制到 Tomcat 的 webapps 目录下（如 D:\apache-tomcat-9.0.60\webapps）。
   • 进入 Tomcat 的 bin 目录，双击 startup.bat（Windows）或执行 ./startup.sh（Linux/Mac）启动 Tomcat。
   • 访问测试：打开浏览器，输入 http://localhost:8080/[WAR 包名]/index.html（如 WAR 包名为 demo.war，则路径为 http://localhost:8080/demo/index.html），能正常显示页面即部署成功。
2. 注意事项：若 Tomcat 启动失败，可查看 logs 目录下的 catalina.out 文件，排查端口占用、依赖冲突等问题。

六、常见问题解决方案（打包/部署高频坑）

6.1 问题 1：WAR 包内无 lib 依赖（第三方 jar 缺失）

• 现象：部署后报错'ClassNotFoundException'（找不到 Spring、MyBatis 等依赖类）。
• 原因：Artifacts 配置中未添加项目依赖的库文件。
• 解决方案：在「Artifacts」→「Output Layout」中，右键「WEB-INF」→选择「Add Library Files」→勾选项目依赖的库（如 Spring Core、MyBatis）→点击「OK」，重新打包。

6.2 问题 2：classes 目录为空（无 .class 文件）

• 现象：打开 WAR 包，WEB-INF/classes 目录下无任何文件。
• 原因：未关联 Module Output，或代码未编译。
• 解决方案：
  1. 重新执行「3.4 关联 Module Output」步骤，确认模块选择正确。
  2. 先执行「Build」→「Rebuild Project」编译项目，再重新打包。

6.3 问题 3：部署后访问 404（页面找不到）

• 现象：浏览器输入地址后显示'404 Not Found'。
• 原因：WAR 包未被 Tomcat 解压，或访问路径错误，或 Tomcat 端口被占用。
• 解决方案：
  1. 检查 webapps 目录：启动 Tomcat 后，若 WAR 包未自动解压（无同名文件夹），删除 WAR 包，重启 Tomcat 重试。
  2. 核对访问路径：确保路径中包含 WAR 包名（如 http://localhost:8080/demo/index.html，而非 http://localhost:8080/index.html）。
  3. 检查端口：打开 conf/server.xml 文件，查看 <Connector port="8080" 是否被占用，若占用则修改端口（如改为 8081），重启 Tomcat。

七、场景扩展：适配 Maven/多模块项目

7.1 Maven 项目打包（更简洁，无需手动配置 Artifacts）

1. 操作步骤：打开右侧「Maven」面板→展开项目→「Lifecycle」→双击「package」，Maven 会自动编译、打包，WAR 包存放在 target 目录下。

自定义配置：若需修改 WAR 包名称，在 pom.xml 中添加：

<build><finalName>my-demo</finalName><!-- 自定义 WAR 包名 --></build>

7.2 多模块项目打包（仅打包 Web 模块）

• 操作要点：多模块项目（如 demo-parent 下有 demo-service、demo-web），仅需对 demo-web 模块（Web 类型）执行上述打包步骤，无需处理父模块或服务模块。

八、总结

本文覆盖 WAR 包配置、打包、验证、部署及排错全流程，核心是确保「Artifacts 配置完整」和「提前验证打包结果」。