在Java Web开发中,Tomcat是最常用的轻量级Servlet容器,IDEA作为主流的Java开发工具,二者结合可以高效完成项目的开发与部署。下面详细介绍完整的操作流程。

一、环境准备
在开始操作前,需要确保本地已经安装好以下环境:
- JDK 1.8及以上版本,并且正确配置了JAVA_HOME环境变量
- IntelliJ IDEA 旗舰版(社区版不支持Java Web开发相关功能)
- Tomcat 8.5及以上版本安装包
二、Tomcat下载与安装
首先从Tomcat官网下载对应系统的安装包,Windows系统选择zip压缩包版本即可,下载完成后解压到无中文、无空格的目录,比如D:tomcatapache-tomcat-9.0.65。
解压完成后可以测试Tomcat是否正常运行,进入解压目录的bin文件夹,双击startup.bat(Windows系统)或者执行startup.sh(Linux/Mac系统),如果看到控制台输出Tomcat启动成功的日志,且浏览器访问http://localhost:8080可以出现Tomcat默认欢迎页,说明Tomcat安装正常。
三、IDEA中配置Tomcat服务器
打开IDEA,按照以下步骤添加Tomcat服务器配置:
- 点击顶部菜单栏的File -> Settings(Windows)或者IntelliJ IDEA -> Preferences(Mac)
- 在左侧导航栏找到Build, Execution, Deployment -> Application Servers
- 点击右上角的+号,选择Tomcat Server
- 在弹出的窗口中,点击Tomcat Home右侧的浏览按钮,选择之前解压的Tomcat根目录,IDEA会自动识别Tomcat的版本信息,点击OK保存配置
四、创建Java Web项目
配置好Tomcat后,我们可以创建一个测试用的Java Web项目:
- 点击File -> New -> Project
- 左侧选择Java Enterprise,勾选Web Application选项,确保Application Server选择的是刚才配置的Tomcat,点击Next
- 填写项目名称和项目存储路径,点击Finish完成项目创建
项目创建完成后,目录结构如下:
- src:存放Java源代码
- web:存放Web相关资源,其中WEB-INF文件夹下的web.xml是项目配置文件,lib文件夹用于存放项目依赖的jar包
- index.jsp:默认的首页文件
五、部署项目到Tomcat
项目创建完成后,需要将项目部署到配置好的Tomcat服务器上:
- 点击IDEA顶部工具栏的Add Configuration按钮
- 在弹出的窗口中点击左上角的+号,选择Tomcat Server -> Local
- 在Server标签页中,确认Application Server是之前配置的Tomcat,设置HTTP端口为8080,JMX端口可以保持默认
- 切换到Deployment标签页,点击右侧的+号,选择Artifact,选择项目的war包或者war exploded模式,war exploded模式支持热部署,开发时更方便
- 在Application context中设置项目的访问路径,比如设置为/,则项目访问地址为http://localhost:8080,设置为/demo则访问地址为http://localhost:8080/demo
- 点击OK保存配置
六、运行项目并验证
部署完成后,点击IDEA顶部工具栏的绿色运行按钮,启动Tomcat服务器:
- 如果控制台输出Tomcat启动成功,且没有报错信息,说明项目部署成功
- IDEA会自动打开浏览器访问项目的首页,或者手动在浏览器输入设置的访问地址,看到index.jsp页面的内容说明运行正常
我们可以修改index.jsp的内容测试效果,比如添加一段Java代码:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>测试页面</title>
</head>
<body>
<h1>Hello Java Web</h1>
<p>当前时间:<%= new java.util.Date() %></p>
</body>
</html>
保存后刷新浏览器页面,就可以看到更新后的内容,说明热部署生效。
七、常见问题排查
部署过程中可能会遇到一些常见问题,可以参考以下思路排查:
- 启动时报端口被占用:可以修改Tomcat的端口号,或者关闭占用8080端口的进程
- 404错误:检查Application context设置是否正确,项目是否成功部署到Tomcat的webapps目录
- JSP页面无法解析:检查JDK版本是否和Tomcat兼容,JAVA_HOME环境变量是否配置正确
- 类找不到错误:检查项目依赖的jar包是否放在WEB-INF/lib目录下,或者是否添加到项目的依赖库中