不用Maven？手把手教你用IDEA 2023纯手工搭建Tomcat 8.5 Web项目

IDEA2023TomcatWeb项目服务器配置

于 2026-05-29 11:25:44 修改

·本内容遵循CC 4.0 BY-SA版权协议

不用Maven？手把手教你用IDEA 2023纯手工搭建Tomcat 8.5 Web项目

在当今自动化构建工具盛行的时代，Maven和Gradle几乎成为了Java项目管理的标配。然而，理解一个Web项目最原始的构建过程仍然具有不可替代的价值。本文将带你回到"石器时代"，使用IntelliJ IDEA 2023旗舰版和Tomcat 8.5，完全手动搭建一个可运行的Java Web项目，不依赖任何构建工具。

这种原始方法特别适合以下场景：

需要深入理解Web项目结构的初学者
受限于网络环境无法使用Maven仓库的情况
希望完全掌控项目依赖和构建过程的高级开发者
维护老旧项目时需要手动管理依赖的场合

1. 环境准备与项目初始化

1.1 必备软件安装

开始之前，请确保已准备好以下环境：

IntelliJ IDEA 2023 Ultimate：社区版(Community)缺少对Java EE的支持，必须使用旗舰版
JDK 1.8+：推荐使用Oracle JDK或OpenJDK 8
Tomcat 8.5：从Apache官网下载二进制发行版并解压

提示：学生可以通过JetBrains官网申请免费的教育授权使用旗舰版IDEA。

1.2 创建基础项目结构

不同于Maven项目的自动生成，我们需要手动构建每个目录：

打开IDEA，选择"New Project"
在左侧选择"Java"，不要勾选任何构建系统(Build Tools)
设置项目名称和位置，选择已安装的JDK版本
点击"Create"完成基础项目创建

初始项目结构如下：

TEXT

manual-web-project

└── .idea

├── misc.xml

└── modules.xml

2. 构建Web模块核心结构

2.1 添加Web模块支持

传统Web项目需要特定的目录结构才能被Tomcat识别：

右键项目根目录 → New → Module
选择"Java" → 命名模块(如"webapp") → 确保使用项目JDK
在模块上右键 → Add Framework Support → 勾选"Web Application"

此时项目结构应变为：

TEXT

manual-web-project

├── .idea

├── webapp

│ ├── src

│ └── web

│ ├── WEB-INF

│ │ └── web.xml

│ └── index.jsp

└── webapp.iml

2.2 手动配置部署描述符

web.xml是传统Java Web项目的核心配置文件，即使现代应用大多使用注解，了解其结构仍有价值：

XML

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee

http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"

version="4.0">

<display-name>Manual Web Project</display-name>

<welcome-file-list>

<welcome-file>index.jsp</welcome-file>

</welcome-file-list>

</web-app>

3. 依赖管理的两种手动方案

3.1 项目级共享库配置

对于多模块项目，可以在项目根目录创建共享库：

在项目根目录新建lib文件夹
将所需JAR文件(如Servlet API)复制到此目录
右键lib文件夹 → Add as Library → 选择"Project Library"

关键目录结构：

TEXT

manual-web-project

├── lib

│ ├── servlet-api.jar

│ └── jstl-1.2.jar

└── webapp

3.2 模块级私有库配置

对于模块专属依赖，更推荐WEB-INF下的lib方案：

在webapp/web/WEB-INF下创建lib目录
复制JAR文件到此目录
右键lib → Add as Library → 选择"Module Library"

这种方式的优势在于：

依赖与模块紧密绑定
符合传统Java Web应用部署规范
部署时无需额外配置，所有依赖会自动打包

4. Tomcat服务器深度配置

4.1 创建本地Tomcat运行配置

点击IDEA右上角"Add Configuration" → "+" → Tomcat Server → Local
在"Server"选项卡配置：
- Name：自定义服务器名称(如"Tomcat 8.5")
- Application server：指定Tomcat安装目录
- HTTP port：默认8080(可修改避免冲突)

4.2 部署工件与上下文配置

切换到"Deployment"选项卡 → "+" → Artifact
选择"webapp:war exploded"（开发模式推荐）
设置Application context（如"/manual-web"）

关键配置参数对比：

配置项	开发环境推荐值	生产环境建议
部署类型	war exploded	war archive
上下文路径	/app-name	/ (根路径)
更新策略	热交换资源	完全重启
JVM参数	-Xmx512m	-Xmx2G -XX:+UseG1GC

4.3 解决常见部署问题

手动管理依赖时最常遇到的两个问题：

问题1：部署后找不到依赖类

检查JAR是否位于WEB-INF/lib下
确认已"Add as Library"
重启Tomcat服务器

问题2：修改不生效

清理Tomcat工作目录($CATALINA_BASE/work)
在IDEA中执行Build → Rebuild Project
检查"Server"选项卡中的"On Update action"设置

5. 开发流程与实用技巧

5.1 手动热部署配置

虽然不如专业工具方便，但可以配置基本的热更新：

在Tomcat配置的"Server"选项卡：
- On 'Update' action: Update classes and resources
- On frame deactivation: Update classes and resources
设置IDEA自动编译：
- File → Settings → Build → Compiler
- 勾选"Build project automatically"

5.2 调试技巧与日志配置

手动项目更需要完善的日志系统：

添加日志依赖到WEB-INF/lib：
- log4j2-core-2.17.1.jar
- log4j2-api-2.17.1.jar
在WEB-INF/classes下创建log4j2.xml：

XML

<?xml version="1.0" encoding="UTF-8"?>

</Console>

</Appenders>

</Root>

</Loggers>

</Configuration>

5.3 传统Web项目的最佳实践

经过多个手动项目的实践，总结出以下经验：

保持WEB-INF/lib中的依赖最小化
定期检查JAR文件冲突(特别是Servlet API版本)
为每个模块维护一个README.md记录特殊配置
使用相对路径引用资源，避免生产环境路径问题
开发阶段保留web.xml，即使使用注解配置

这种手动方式虽然繁琐，但在排查构建问题时，对项目结构的深入理解往往能节省大量时间。当自动构建工具出现难以诊断的问题时，回退到基本原理往往是最有效的解决方案。