IDEA 中 Tomcat 部署 Java Web 项目（Maven 多模块 & 非 Maven 通用版）

引言

Java Web 开发中，Tomcat 是最常用的 Servlet 容器，而项目类型通常分为 Maven 管理（依赖自动处理、多模块聚合） 和 非 Maven 纯手工管理（手动引入 jar 包、配置项目结构）。本文覆盖 两种项目类型 的 Tomcat 部署全流程，从 IDEA 配置到问题排查，手把手教你打通开发到运行的闭环，解决 90% 部署痛点！

一、环境准备（通用基础）

1. 核心环境

• JDK：确保安装 JDK 1.8+（示例用 1.8 Oracle OpenJDK），通过 java -version 验证。
• Tomcat：本地安装 Tomcat 8.5+（如 apache-tomcat-8.5.29），记住安装目录（后续配置用）。
• IDEA：旗舰版或社区版（社区版需手动配置部分功能，本文以旗舰版为例）。

二、场景 1：Maven 多模块 Java Web 项目部署

1. 项目特征

• 含 pom.xml，通过 Maven 管理依赖和多模块（如父模块 hami_parent + 子模块 hami_protal）。
• 构建流程：clean → install 自动编译、打包，适合复杂聚合项目。
• 
•  依次为每个部分添加本地tomcat-server
• 

       修改名字，热部署，端口号，jdk都不要填错

这里添加相应的 

点击apply ->ok  运行tomcat

（2）Maven 构建：生成 War 包

• 右侧打开 Maven 面板，找到父模块（如 hami_parent [root]）：
  • 先双击 Lifecycle → clean（清理旧构建产物）。
  • 再双击 Lifecycle → install（编译代码 → 打包成 war → 安装到本地仓库）。
  • 
• 控制台输出 BUILD SUCCESS 后，检查子模块 target 目录，生成 xxx.war 和 xxx.war exploded（部署用解压包）。
• 

三、场景 2：非 Maven Java Web 项目部署（以 BookShop 为例）

1. 项目特征

• 无 pom.xml，手动管理 jar 包（如 commons-codec-1.9.jar 放 WEB-INF/lib）。
• 需手动配置项目结构、依赖、Web 模块，适合简单 Demo 或旧项目迁移。

2. 关键配置步骤

（1）Project Structure 全流程配置

• 打开 File → Project Structure，按以下标签逐步配置：

① Project 标签（基础环境）

• Name：项目名（如 BookShop）。
• SDK：选 JDK 1.8。
• Language level：选 8 - Lambdas, type annotations。

② Modules 标签（模块与依赖）

• 选项目模块（如 BookShop）：
  • Sources：标记 src 为源码目录（蓝色），test 为测试目录（绿色，可选）。
  • Dependencies：
    • 点击 + → JARS or directories，引入 WEB-INF/lib 下的所有 jar 包（如 commons-codec-1.9.jar、mysql-connector-java-5.1.5.jar）。

③ Facets 标签（Web 模块识别）

• 点击 + → Web，关联项目的 web.xml（路径：WebContent/WEB-INF/web.xml）：
  • 确认 Deployment Descriptors 中 web.xml 路径正确。
  • 配置 Web Resource Directories（如 WebContent 目录，作为静态资源根路径）。

④ Artifacts 标签（部署产物配置）

• 点击 + → Web Application: Exploded → From Modules...，选项目模块（如 BookShop）：
  • 生成 BookShop:war exploded（解压后的 Web 应用目录，用于 Tomcat 部署）。
  • 检查 Output Layout，确保 WEB-INF/classes（编译输出）和 WEB-INF/lib（jar 包）已包含。

 选中自己的项目

2）Tomcat Server 配置（与 Maven 项目类似）

• 顶部 Run → Edit Configurations → 新建 Tomcat Server → Local：
  • Server 标签：同 Maven 项目（选 Tomcat 目录、JDK、端口）。
  • Deployment 标签：
    • 点击 + → Artifact，选 BookShop:war exploded（非 Maven 项目的解压部署包）。
  • 热部署：同 Maven 项目（选 Update classes and resources）。

3）启动验证

• 启动 Tomcat 后，访问 http://localhost:8085/BookShop/（路径与 Application context 一致），验证页面或接口。

四、总结

• Maven 项目：依赖管理便捷，适合复杂多模块，通过 clean/install 自动构建，部署流程更标准化。
• 非 Maven 项目：需手动配置依赖和结构，适合简单场景或旧项目，重点关注 Facets 和 Artifacts 配置。

无论哪种类型，掌握 Tomcat 热部署 和 Project Structure 核心配置 是关键！遇到问题先检查日志（IDEA 控制台 + Tomcat catalina.out），结合本文解决方案，部署效率直接拉满～