Tomcat部署——个人笔记

关注

原创最新推荐文章于 2026-05-29 10:58:07 发布 967 阅读 AI 写同款· GEO 优化 ›

Tomcat部署Web项目的3种方式 Tomcat部署Web项目的3种方式一、将war包丢进webapps 这是最简单粗暴的方式：将web工程打成war，丢进tomcat/webapps目录即可，tomcat会自动解压。无需修改任何配置文件即可完成部署。这里我准备了tomcat8.5.43与dubbo控制台的war包来做测试。 ①启动tomcat ②将war丢进webapps目录，tomcat会自动解压该war包。浏览器直接访问：localhost:8080/dubbo-admin-2.5.10，说明我们的war包部署成功！（访问路径阅读详情

Tomcat部署——个人笔记

文章目录

@[toc]
简介
安装
配置文件
WEB项目的标准结构
WEB项目部署
IDEA中开发并部署运行WEB项目

本学习笔记参考尚硅谷等教程。

简介

Apache Tomcat 官网

Tomcat是Apache 软件基金会（Apache Software Foundation）的Jakarta 项目中的一个核心项目，由Apache、Sun 和其他一些公司及个人共同开发而成。由于有了Sun 的参与和支持，最新的Servlet 和JSP 规范总是能在Tomcat 中得到体现。Tomcat 服务器是一个免费的开放源代码的Web 应用服务器，属于轻量级应用服务器，在中小型系统和并发访问用户不是很多的场合下被普遍使用，是开发和调试JSP 程序的首选。

安装

下载

进入官网，查看左边侧边栏（若没出现可能是浏览器窗口宽度不够，拉长之后自动出现），在Download一栏中选择要下载的Tomcat版本。

注意：Tomcat 9 之前开发的项目在 Tomcat 10之后的版本不兼容。

根据表中提示选择要下载的Tomcat 版本：Apache Tomcat® - Tomcat的版本选择

此处我选择用Java 17来进行开发，所以我选择的是Tomcat 10，详细版本为10.1.26

下载Tomcat 10对应的压缩文件：64-bit Windows zip，之后在适合的位置解压缩。

配置环境变量

右键”我的电脑“ → 系统设置 → 高级系统设置 → 高级 → 环境变量 → 系统变量 → 新建

变量名中填写： JAVA_HOME

变量值中填写：你的JAVA的根目录（使用 IDEA 会自动下载JAVA，所以可以去IDEA查找对应 JAVA 的下载目录）

测试

在 Tomcat 的解压根目录中，打开 bin/startup.bat ，若启动成功，则安装完成。若闪退，则可能是配置JAVA_HOME的时候出错。

启动成功之后，观察倒数第二行出现的“http-nio-数字”，此数字为端口(一般默认为8080)。在浏览器中输入 localhost:数字 ，则可进入Tomcat服务器的首页。

Tomcat 的关闭方式：
1.关闭Tomcat的运行窗口
2.运行bin/shutdown.bat

配置文件

启动成功 Tomcat 时，窗口内字体为乱码（cmd默认编码方式为GBK，而Tomcat编码默认为UTF-8)
在conf/logging.properties中修改 java.util.logging.ConsoleHandler.encoding项，使其=GBK。

其他情况出现乱码也如上，在对应的配置项操作。

conf/server.xml 中可以修改服务器相关配置（如端口号修改）

conf/tomcat-users.xml 配置管理类型项目的账号密码

WEB项目的标准结构

一个标准的可以用于发布的WEB项目标准结构如下

Tomcat 根目录 / webapps
│
└─app/
│
├─ static/
│ ├── css
│ ├── img
│ └── js
│
├─ WEB-INF/
│ ├── classes
│ ├── lib
│ └── web.xml
│
└─ index.html

app 本应用根目录
- static 非必要目录,约定俗成的名字,一般在此处放静态资源 ( css js img)
- WEB-INF 必要目录,必须叫WEB-INF,受保护的资源目录,浏览器通过url不可以直接访问的目录
  - classes 必要目录,src下源代码,配置文件,编译后会在该目录下,web项目中如果没有源码,则该目录不会出现
  - lib 必要目录,项目依赖的jar编译后会出现在该目录下,web项目要是没有依赖任何jar,则该目录不会出现
  - web.xml 必要文件,web项目的基本配置文件. 较新的版本中可以没有该文件,但是学习过程中还是需要该文件
- index.html 非必要文件,index.html/index.htm/index.jsp为默认的欢迎页

WEB项目部署

方式1 直接将编译好的项目放在webapps目录下 (已经演示)

方式2 将编译好的项目打成war包放在webapps目录下,tomcat启动后会自动解压war包(其实和第一种一样)

方式3 可以将项目放在非webapps的其他目录下,在tomcat的conf下创建Catalina/localhost目录,并在该目录下准备一个app.xml文件，使Tomcat获取指向该项目的路径。

<Context path="/app" docBase="D:\mywebapps\app" />

IDEA中开发并部署运行WEB项目

打开 IDEA 设置

左侧侧边栏，选中“构建，执行，部署”项（Build，Execution，Deployment)，再选中应用程序服务器(Application Servers)

点击右侧窗口的左上方出现的＋，在弹出菜单选择Tomcat服务器（Tomcat Server)

主目录（Tomcat Home）选择Tomcat的安装目录

点击ok即可关联。

使用Tomcat开发项目时，推荐先创建一个空项目,这样可以在一个空项目下同时存在多个modules,不用后续来回切换之前的项目,当然也可以忽略此步直接创建web项目

使用IDEA创建项目。

创建完成后，选中项目结构（Project Structure)

检查项目的SDK,语法版本,以及项目编译后的输出目录

创建一个普通的JAVA项目

创建完毕后，打开项目结构，为项目添加Tomcat依赖

添加框架支持（选中相应module后，双击shift，搜索"添加框架支持")

删除module目录下出现的index.jsp ,替换为 index.html

处理配置文件

在工程下创建resources目录,专门用于存放配置文件(都放在src下也行,单独存放可以尽量避免文件集中存放造成的混乱)
标记目录为资源目录,不标记的话则该目录不参与编译（右键resources目录，选择"将目录标记为…“，在弹出菜单中选择"资源根目录”)

处理依赖jar包问题

在WEB-INF下创建lib目录
必须在WEB-INF下，且目录名必须叫lib
复制jar文件进入lib目录
将lib目录添加为当前项目的依赖（右键lib目录，选择"添加为库…" → 环境级别推荐选择module 级别,降低对其他项目的影响,name可以空着不写)

在web文件夹下，生成一个 WEB 项目的标准结构，将要开发的项目放入。

配置项目，使其在Tomcat服务器上运行

点击apply 应用后,回到Server部分. After Launch是配置启动成功后,是否默认自动打开浏览器并输入URL中的地址,HTTP port是Http连接器目前占用的端口号

运行项目

访问对应文件，成功

工程结构和可以发布的项目结构之间的目录对应关系

IDEA部署并运行项目的原理

idea并没有直接进将编译好的项目放入tomcat的webapps中
idea根据关联的tomcat,创建了一个tomcat副本,将项目部署到了这个副本中
idea的tomcat副本在C:\用户\当前用户\AppData\Local\JetBrains\IntelliJIdea2022.2\tomcat\中
idea的tomcat副本并不是一个完整的tomcat,副本里只是准备了和当前项目相关的配置文件而已
idea启动tomcat时,是让本地tomcat程序按照tomcat副本里的配置文件运行
idea的tomcat副本部署项目的模式是通过conf/Catalina/localhost/*.xml配置文件的形式实现项目部署的