一、下载
1、Tomcat版本对应关系
向下兼容原则:高版本JDK通常能兼容低版本Tomcat(如JDK 11可运行Tomcat 8.5+),但低版本JDK无法运行高版本Tomcat(如JDK 8不能运行Tomcat 10.1)。
首选:生产环境首选Tomcat 9 + JDK 11(兼顾稳定和现代特性)或Tomcat 10.1 + JDK 17(新一代技术栈)。
| Tomcat 版本 | 最低支持 JDK 版本 | 推荐/主要支持 JDK 版本 | 最高兼容 JDK 版本 | 备注 |
|---|---|---|---|---|
| Tomcat 10.1.x | JDK 11 | JDK 11 / JDK 17 | JDK 21 | 支持 Jakarta EE 10,Servlet 6.0 |
| Tomcat 10.0.x | JDK 8 | JDK 8 / JDK 11 | JDK 17 | 首个支持 Jakarta EE 9 的版本(包名从 javax 改为 jakarta) |
| Tomcat 9.0.x | JDK 8 | JDK 8 / JDK 11 | JDK 17 | 长期支持(LTS)版本,支持 Servlet 4.0,是目前最主流的生产版本 |
| Tomcat 8.5.x | JDK 7 | JDK 8 | JDK 11 | 支持 Servlet 3.1,已停止更新 |
| Tomcat 8.0.x | JDK 7 | JDK 7 / JDK 8 | JDK 8 | 已停止更新 |
| Tomcat 7.0.x | JDK 6 | JDK 7 | JDK 8 | 支持 Servlet 3.0,仅安全维护 |
| Tomcat 6.0.x | JDK 5 | JDK 6 | JDK 7 | 已完全停止维护,不建议生产使用 |
2、下载
官网下载:https://tomcat.apache.org/
找到你需要用的 Tomcat 版本对应的 zip 压缩包,直接解压到需要安装的目录即可(注意路径全英文)。
3、配置环境变量
此电脑—>属性—>高级系统设置—>环境变量—>系统变量(S)—>新建
#新增变量名:CATALINA_HOME#CATALINA_HOME对应变量值:(按照你的实际安装路径)D:\Programming\Apache\Tomcat\apache-tomcat-10.0.27#此电脑--->属性--->高级系统设置--->环境变量--->系统变量(S)--->找到Path变量--->编辑--->新建#Path变量新建值%CATALINA_HOME%\bin二、启停
1、启动
找到 Tomcat 目录下的 bin 目录下的 startup.bat 文件,双击,就可以启动 Tomcat 服务器。
2、测试
打开浏览器,在浏览器地址栏中输入以下地址测试:
1、http://localhost:80802、http://127.0.0.1:80803、http://真实 ip:8080当出现如下界面,说明 Tomcat 服务器启动成功!!!
3、停止
1、点击 tomcat 服务器窗口的 x 关闭按钮
2、把 Tomcat 服务器窗口置为当前窗口,然后按快捷键 Ctrl+C
3、找到 Tomcat 的 bin 目录下的 shutdown.bat 双击,就可以停止 Tomcat 服务器
三、配置
1、目录介绍
🐈bin文件夹:存放Tomcat的命令、脚本等文件,其中以.sh结尾的是Linux/Mac OS系统使用命令的。以.bat结尾的则是Windows系统的命令使用的。其他的为通用项。
我们也可以在此处启动和关闭Tomcat,例如在Windows系统下,startup.bat则可以启动Tomcat,shutdown.bat则可以关闭Tomcat。Linux和Mac OS同理,它们可以运行startup.sh,shutdown.sh用来启动和关闭Tomcat。catalina.bat/catalina.sh则可以设置Tomcat的内存。
🐈conf文件夹:存放Tomcat的配置文件等。例如:server.xml文件可以设置端口号、域名、IP、编码等也可以将日志配置到其他目录等 。tomcat-user.xml文件则用来管理配置Tomcat的用户与权限,context.xml用来配置数据源等
🐈lib文件夹:存放Tomcat运行时所必须的JAR包文件。注意的是JAR文件只可以被Tomcat服务器所访问。
🐈logs文件夹:默认日志文件存放的目录,对于我们后期的排查起到非常重要的作用。需要注意的是,如果你是Windows系统,它将存放在以年月日命名的文件中,例如:catalina.2022-11-08.log。如果你是Linux/Mac OS系统,它将存放在catalina.out文件中。
🐈temp文件夹:用来存放Tomcat的运行时的临时文件用。
🐈webapps文件夹:用来存放web应用和部署项目的目录,Tomcat启动时会加载此目录下的项目应用。
2、修改Tomcat默认端口号
Tomcat 默认的端口号是:8080
找到 Tomcat 目录下的 conf 目录,找到 server.xml 配置文件。
3、配置编码(启动日志乱码)
打开我们解压的Tomcat文件夹,找到conf文件夹下的logging.properties文件
#修改此项,改为GBKjava.util.logging.ConsoleHandler.encoding=GBK四、eclipse整合Tomcat
1、配置Tomcat
版本按照大版本选择
例如我是apache-tomcat-9.0.102,就选择9.0
Installed JRES可以选择使用的JDK版本,一般默认即可,也可以手动选择
2、新建服务
3、修改目录
配置 Eclipse 使用 Tomcat 安装目录的 webapps
让 Eclipse 直接使用 Tomcat 原生的webapps目录,避免临时目录的问题
右键Servers的tomcat进行启动
再浏览器打开网址可以正常访问:http://localhost:8080/
五、IDEA整合Tomcat
1、IDEA配置Tomcat
操作的菜单如下:File | Settings | Build, Execution, Deployment | Application Servers
配置你的 Tomcat 安装目录
可以配置多个Tomcat
就可以通过创建一个 Model 查看是不是配置成功!!!
2、IDEA创建动态web工程
1、创建一个新模块:
2、选择你要创建什么类型的模块:3、输入你的模块名,点击【Finish】完成创建
4、创建成功如下图:
3、动态web工程目录介绍
4、给Tomcat添加第三方jar包
1、可以打开项目结构菜单操作界面,添加一个自己的类库:2、添加你你类库需要的 jar 包文件。
3、选择你添加的类库,给哪个模块使用:
4、选择 Artifacts 选项,将类库,添加到打包部署中:
5、在IDEA中启动部署web模板
1、建议修改 web 工程对应的 Tomcat 运行实例名称:
2、确认你的 Tomcat 实例中有你要部署运行的 web 工程模块:
3、你还可以修改你的 Tomcat 实例启动后默认的访问地址:
6、Tomcat实例使用的其他细节说明
修改工程访问路径
修改运行的端口号
修改运行使用的浏览器
配置资源热部署
六、卸载
以管理员身份打开 CMD,执行命令
# 进入 Tomcat 的 bin 目录(替换为你的实际路径)cdD:\apache-tomcat-9.0.80\bin# 移除服务(service.bat 是 Tomcat 自带的服务管理脚本)service.bat remove直接删除 Tomcat 的根文件夹(如 D:\Software\apache-tomcat-9.0.102)
清理环境变量
如果之前配置过 Tomcat 相关环境变量(如 CATALINA_HOME、CATALINA_BASE):
1、右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
2、在「系统变量」中找到 CATALINA_HOME/CATALINA_BASE,点击「删除」。
3、若 Path 变量中包含 Tomcat 的 bin 目录路径,也需删除该条目。
七、常见报错
1、启动失败
双击 startup.bat 文件,就会出现一个小黑窗口一闪而过。
这个时候,失败的原因基本上都是因为没有配置好 JAVA_HOME 环境变量。
检查环境变量配置: