Tomcat 从入门到实战（上篇）：核心概念解析与基础部署指南

一、引言：为什么 Java 应用离不开”容器”？#

和 PHP、纯静态站点不同，Java Web 应用无法直接被 Nginx、Apache 这类传统 Web 服务器解析运行——它必须先被装进一个容器里，由容器负责加载类、管理生命周期、处理请求。Tomcat 就是这个领域事实上的标准答案。本篇带你从零建立概念认知，并完成一套可直接复用于生产环境的标准部署流程。

1.1 这些场景，你是否似曾相识？#

开发交付了一个 demo.war 文件，只留下一句”放 Tomcat 里跑就行”，而你盯着文件不知从何下手
习惯性执行 java -jar demo.war，结果满屏报错，不理解为什么 Spring Boot 可以、传统 Servlet 项目却不行
好不容易启动了 Tomcat，却遭遇端口冲突、页面打不开、日志刷屏看不懂的”新人三连”

为什么会有这些困惑？
根本原因在于对”容器”缺乏认知：传统 Java Web 应用（基于 Servlet 规范）不是独立可执行程序，它只是一堆遵循规范的类文件和资源，必须由 Servlet 容器加载后才能对外提供服务。而 Spring Boot 之所以 java -jar 就能跑，是因为它内嵌了一个 Tomcat。

1.2 目标读者与前置知识#

项目	说明
适合读者	初级运维工程师、需自行部署 Java 应用的后端开发、转行运维的初学者
前置知识	Linux 基础命令（解压、查看进程/端口）、Java 环境概念、HTTP 协议与端口基础
实验环境	一台 CentOS 7.9 虚拟机或云服务器（Ubuntu 22.04 用户见文中差异标注）

1.3 本篇学习目标#

说清楚：Tomcat 的定位、核心组件层级与一次 HTTP 请求的完整处理流程
做出来：独立完成 JDK 准备、Tomcat 安装、端口配置、服务启停与第一个 WAR 包发布
查得动：掌握”看日志 → 查端口 → 查防火墙”排错三板斧，解决 80% 的基础部署故障

二、核心概念与环境准备#

在动手敲命令之前，先花几分钟建立正确的概念模型。Tomcat 的报错日志与配置文件中充斥着 Catalina、Connector、Context 这类术语，提前理清它们的层级关系，后续部署与排错才能事半功倍。

2.1 核心术语速查#

以下术语贯穿 Tomcat 所有配置与日志，建议对照理解后再继续：

Tomcat : Apache 基金会开源的轻量级 Web 应用服务器，本质是一个 Servlet/JSP 容器

Servlet 容器 : 负责加载、实例化、调用 Servlet 并管理其生命周期的运行时环境

Catalina : Tomcat 的 Servlet 容器核心模块名称，也是主启动脚本 catalina.sh 的由来

Connector（连接器） : 监听端口、接收 HTTP 请求并转交容器处理的组件（默认监听 8080）

Engine / Host / Context : 三级容器结构：引擎 → 虚拟主机 → Web 应用，一个 Context 对应一个具体项目

WAR 包 : Web Application Archive，Java Web 应用的标准打包格式，放入 webapps/ 目录即可自动解压部署

2.2 版本环境说明#

本篇所有操作基于以下环境实测通过：

操作系统：CentOS 7.9（Ubuntu 22.04 差异命令随文标注）
JDK：OpenJDK 1.8.0_392
Tomcat：9.0.85

选型警示：新手请勿直接使用 Tomcat 10.x
Tomcat 10.x 将 Java EE 的 javax.* 包命名空间整体迁移至 jakarta.*，导致绝大多数基于 javax.servlet 开发的老项目直接部署即报错（ClassNotFoundException: javax.servlet.*）。JDK 兼容性方面：Tomcat 9 要求 JDK 8+，Tomcat 10.1 要求 JDK 11+。新手建议从 Tomcat 9.x 入手，生态最成熟、教程最丰富。

2.3 架构解析：一次 HTTP 请求的旅程#

Tomcat 的整体架构遵循清晰的嵌套层级，自顶向下为：Server → Service → Connector + Engine → Host → Context。当你在浏览器输入 http://IP:8080/demo 时，请求的完整处理链路如下：

graph TD
    A[浏览器发起 HTTP 请求] --> B[Connector 监听 8080 端口接收请求]
    B --> C[Engine 引擎接收并分发]
    C --> D{匹配 Host 虚拟主机}
    D --> E{匹配 Context 应用路径 /demo}
    E --> F[调用对应 Servlet 处理业务]
    F --> G[响应沿原路返回浏览器]

    style A fill:#e1f5ff,stroke:#0288d1
    style G fill:#e8f5e9,stroke:#388e3c

与 Nginx 的定位差异
Nginx 擅长处理静态资源与高并发反向代理，Tomcat 擅长执行动态 Java 逻辑，但静态资源处理性能较弱。生产环境的经典组合是”Nginx 在前做反代与动静分离，Tomcat 在后跑业务”，这一架构将在下篇详细展开。

2.4 安装后的目录结构#

解压 Tomcat 后，你会看到以下标准目录，务必记住前四个——它们是日常运维的主战场：

目录	用途	运维频率
`bin/`	启停脚本（`startup.sh`、`shutdown.sh`、`catalina.sh`）	高
`conf/`	配置文件（`server.xml`、`web.xml` 等）	高
`webapps/`	应用部署目录，WAR 包放这里自动解压	高
`logs/`	日志目录（`catalina.out`、`localhost_access_log`）	高
`work/`	JSP 编译后的临时工作目录	低
`lib/`	Tomcat 自身及全局共享的 JAR 包	低
`temp/`	临时文件目录	低

2.5 核心配置文件速览#

conf/ 目录下四个文件各有分工，本篇只会用到前三个：

server.xml：端口、连接器、虚拟主机主配置 —— 本篇核心，改动最频繁
web.xml：全局 Web 应用默认配置，不建议随意修改
tomcat-users.xml：Manager 管理界面的账号与权限配置
context.xml：全局 Context 配置，进阶场景使用

三、详细部署与配置步骤#

本章是全文核心，按照「装 JDK → 装 Tomcat → 改配置 → 启服务 → 发应用」五步闭环展开。所有命令均在 CentOS 7.9 上实测通过，请按顺序执行，每一步都附带预期输出用于自检。

3.1 步骤一：环境初始化（JDK 安装与校验）#

Tomcat 是纯 Java 编写的，JDK 是它运行的先决条件。缺少 Java 环境时启动脚本会静默失败或直接报错，这是新手最常踩的第一个坑。

3.1.1 安装 OpenJDK 8#

1
# CentOS 7
2
yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel
3

4
# Ubuntu 22.04（备选）
5
apt update && apt install -y openjdk-8-jdk

3.1.2 校验安装结果#

1
java -version

预期输出如下，看到版本号即说明安装成功：

1
openjdk version "1.8.0_392"
2
OpenJDK Runtime Environment (build 1.8.0_392-b08)
3
OpenJDK 64-Bit Server VM (build 25.392-b08, mixed mode)

3.1.3 配置 JAVA_HOME 环境变量#

Tomcat 启动脚本依赖 JAVA_HOME 定位 JDK，执行以下三步完成配置：

1
# 1. 查找 JDK 实际安装路径
2
dirname $(dirname $(readlink -f $(which java)))
3

4
# 2. 写入 /etc/profile（路径以上一步输出为准）
5
cat >> /etc/profile <<'EOF'
6
export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk
7
export PATH=$JAVA_HOME/bin:$PATH
8
EOF
9

10
# 3. 使配置生效并验证
11
source /etc/profile && echo $JAVA_HOME

3.2 步骤二：Tomcat 下载与安装#

前往 Apache 官方归档站下载 9.0.x 稳定版，解压至 /usr/local 并创建软链接——软链接是运维好习惯，未来升级版本只需切换链接指向，配置文件中的路径无需任何改动。

3.2.1 下载并解压#

1
cd /usr/local/src
2
wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.85/bin/apache-tomcat-9.0.85.tar.gz
3
tar -zxf apache-tomcat-9.0.85.tar.gz -C /usr/local/
4
ln -s /usr/local/apache-tomcat-9.0.85 /usr/local/tomcat

3.2.2 赋权并确认目录结构#

1
chmod +x /usr/local/tomcat/bin/*.sh
2
ls /usr/local/tomcat

预期输出与 2.4 节的目录结构一一对应：

1
bin  conf  lib  logs  temp  webapps  work

为什么推荐官方压缩包而非 yum 安装？
yum install tomcat 会把文件拆散到 /etc、/var、/usr/share 等多个系统目录，升级与多实例部署都极不方便。官方压缩包单目录自包含，删除目录即完成卸载，是生产环境的主流做法。

3.3 步骤三：核心配置项修改（server.xml）#

server.xml 是 Tomcat 的”大脑”，所有端口、线程、虚拟主机配置都集中于此。本篇只做两项最小必要改动：修复中文乱码、初步调整连接数。修改前建议先备份：cp server.xml server.xml.bak。

3.3.1 修改 HTTP 端口与 URI 编码#

找到 <Connector port="8080" ...> 段，追加 URIEncoding="UTF-8" 属性。这一行解决的是 GET 请求参数中文乱码 的经典问题，属于必改项：

1
<Connector port="8080" protocol="HTTP/1.1"
2
           connectionTimeout="20000"
3
           redirectPort="8443"
4
           URIEncoding="UTF-8" />

3.3.2 基础连接数调整#

默认线程参数偏保守，这里给出一组适合中小型项目的起步值：

1
<Connector port="8080" protocol="HTTP/1.1"
2
           connectionTimeout="20000"
3
           maxThreads="500"
4
           minSpareThreads="50"
5
           acceptCount="200"
6
           URIEncoding="UTF-8" />

各参数含义对照如下：

参数	默认值	本篇建议值	说明
`maxThreads`	200	500	最大工作线程数，决定同时处理的请求上限
`minSpareThreads`	10	50	最小空闲线程数，避免突发流量时临时创建线程的开销
`acceptCount`	100	200	线程全忙时，新请求的排队队列长度，超出直接拒绝
`connectionTimeout`	20000	20000	建立连接后等待请求数据的超时时间（毫秒）

调优说明
本篇先用保守值保证”能跑通”，JVM 堆内存、NIO/APR 协议、线程池联动等深度调优内容统一放在下篇展开，避免参数堆砌却不知所云。

3.4 步骤四：服务启动与功能验证#

配置就绪，现在启动服务。本节的关键不是”敲一条启动命令”，而是建立启动后必做三重验证的肌肉记忆——进程、端口、日志，三者确认无误才算真正启动成功。

3.4.1 启动服务#

1
/usr/local/tomcat/bin/startup.sh

预期输出：

1
Using CATALINA_BASE:   /usr/local/tomcat
2
Using CATALINA_HOME:   /usr/local/tomcat
3
Using CATALINA_TMPDIR: /usr/local/tomcat/temp
4
Using JRE_HOME:        /usr/lib/jvm/java-1.8.0-openjdk
5
Tomcat started.

3.4.2 三重验证（进程、端口、日志）#

1
ps -ef | grep tomcat | grep -v grep          # ① 验证进程存在
2
ss -lntp | grep 8080                          # ② 验证端口监听
3
tail -f /usr/local/tomcat/logs/catalina.out   # ③ 验证启动日志

日志中出现以下关键行，代表容器初始化完成、可以对外服务：

1
org.apache.catalina.startup.Catalina.start Server startup in [1523] ms

三重验证缺一不可
只看到 Tomcat started. 并不代表启动成功——该提示仅表示脚本执行完毕。进程在但端口没监听（配置错误）、端口在听但日志有异常（应用加载失败）都是常见假象，必须三项全部通过。

3.4.3 浏览器访问验证#

浏览器访问 http://服务器IP:8080，预期出现经典的三脚猫默认首页
若无法访问，先执行防火墙放行：

1
# CentOS 7（firewalld）
2
firewall-cmd --permanent --add-port=8080/tcp && firewall-cmd --reload
3

4
# Ubuntu 22.04（ufw）
5
ufw allow 8080/tcp

3.4.4 优雅停止服务#

1
/usr/local/tomcat/bin/shutdown.sh

禁止直接 kill -9 强杀进程
kill -9 会导致部署中的应用数据损坏、端口陷入 TIME_WAIT 状态迟迟无法释放（表现为重启后报端口占用）。正确顺序是：shutdown.sh → 无效则 kill <PID> → 仍无效最后才考虑 kill -9。

3.5 步骤五：部署第一个 Web 应用#

环境就绪，进入运维的核心动作——发布应用。Tomcat 支持两种主流发布方式：WAR 包热部署（最常用）与 Manager 图形化部署（适合多应用管理），本节两种都掌握。

3.5.1 WAR 包热部署#

1
cp demo.war /usr/local/tomcat/webapps/
2
ls /usr/local/tomcat/webapps/

预期输出中，demo.war 已被自动解压为同名目录（无需重启）：

1
demo  demo.war  docs  examples  host-manager  manager  ROOT

随后访问 http://服务器IP:8080/demo 即可看到应用页面。访问路径中的 /demo 对应的就是 Context——回看 2.1 节的术语，此刻它不再抽象。

热部署原理与 ROOT 技巧
Tomcat 默认开启 autoDeploy，会实时监控 webapps/ 目录，检测到新 WAR 包即自动解压加载。若希望应用直接通过 http://IP:8080/ 根路径访问，将 WAR 包重命名为 ROOT.war 再传入即可。

3.5.2 配置 Manager 管理界面#

Manager 是 Tomcat 自带的 Web 控制台，可图形化完成应用的部署、启停、下线。默认无账号，需手动配置两步：

第一步：在 tomcat-users.xml 末尾的 </tomcat-users> 标签之前追加角色与账号：

1
<tomcat-users>
2
  <role rolename="manager-gui"/>
3
  <role rolename="admin-gui"/>
4
  <user username="admin" password="Tomcat@123" roles="manager-gui,admin-gui"/>
5
</tomcat-users>

第二步：Manager 默认仅允许本机访问，需注释掉远程访问限制的 Valve：

1
<Context antiResourceLocking="false" privileged="true" >
2
  <!-- 注释或删除下面这行，允许远程访问 -->
3
  <Valve className="org.apache.catalina.valves.RemoteAddrValve"
4
         allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />
5
</Context>

重启服务后访问 http://服务器IP:8080/manager/html，输入账号即可看到应用列表，体验图形化的 Deploy / Start / Stop / Undeploy 操作。

生产环境安全红线
示例中的 Tomcat@123 仅为教学演示，生产环境必须满足三点：① 使用高强度独立密码；② 绝不对公网开放 Manager 界面；③ 通过 Nginx 限制来源 IP 或干脆删除 webapps/manager 目录。Manager 被爆破是 Tomcat 服务器被入侵的头号途径。

四、选型对比：主流 Java Web 容器横向评估#

学会了部署，还需要理解”为什么是 Tomcat”。Java Web 容器并非只有一家，不同场景下的最优解各不相同。本节通过横向对比帮你建立选型判断力，并给出 Tomcat 自身的版本选择建议。

4.1 主流容器横向对比#

维度	Tomcat	Jetty	Undertow	Nginx
定位	Servlet 容器	嵌入式容器	高性能容器	静态/反代服务器
资源占用	中	轻	轻	极轻
典型场景	传统 WAR 项目	嵌入式应用/测试	Spring Boot 内嵌	静态资源 + 负载均衡
学习成本	低	中	中	低

可以看到，四者并非完全竞争关系：Nginx 不懂 Servlet 规范，与 Tomcat 是搭档而非对手；Jetty 与 Undertow 则更多以”内嵌形态”出现在现代框架中。

4.2 Tomcat 版本选择建议#

8.5.x：老项目兼容首选，但已接近 EOL，新项目不建议再引入
9.0.x：当前推荐版本，支持 Servlet 4.0，稳定且生态成熟，兼容 javax.* 老项目
10.1.x：支持 Servlet 6.0，全面切换至 jakarta.* 命名空间，仅适合从零起步的新项目

一句话选型原则
维护老项目选 9.0.x，全新项目且团队熟悉 Jakarta EE 规范可选 10.1.x；不确定时，一律选 9.0.x 不会错。

五、常见问题与排错#

部署过程中遇到的问题，90% 集中在以下五类。本节按”现象 → 定位 → 解决”的结构逐一拆解，并给出可直接复用的排查命令。建议先收藏，遇到问题时对照翻阅。

5.1 启动报错：端口被占用#

最典型的启动失败，日志中出现 java.net.BindException: Address already in use，说明 8080 端口已被其他进程占用。

1
ss -lntp | grep 8080        # 定位占用进程及其 PID
2
kill <PID>                  # 释放端口后重新启动

5.2 启动正常但页面无法访问#

进程、端口、日志三重验证全部通过，浏览器却迟迟打不开页面。按以下链路自内向外逐层排查：

防火墙：检查 firewalld（CentOS）或 ufw（Ubuntu）是否放行 8080
云安全组：登录云控制台，确认入站规则已放行 8080 端口
监听地址：ss -lnt | grep 8080 确认监听在 0.0.0.0 而非 127.0.0.1

云服务器场景
云上部署时，90% 的”访问不了”是安全组未放行，而非 Tomcat 本身的问题。排查时先查安全组，可节省大量无效排查时间。

5.3 JDK 版本不匹配#

现象：catalina.out 中出现 Unsupported major.minor version 52.0
根因：用低版本 JDK 运行了高版本编译的类文件（52.0 对应 JDK 8，说明当前 JDK 低于 8）
解决：升级 JDK 至与编译版本匹配，或让开发用当前 JDK 版本重新打包

5.4 页面 / 日志中文乱码#

乱码分两类，对症下药：

乱码位置	根因	解决方案
页面 GET 参数乱码	连接器未指定 URI 编码	`server.xml` 追加 `URIEncoding="UTF-8"`（3.3 节已完成）
`catalina.out` 日志乱码	控制台输出编码不匹配	修改 `conf/logging.properties` 中的 `java.util.logging.ConsoleHandler.encoding = UTF-8`

5.5 虚拟机环境启动极慢（数分钟）#

现象：日志长时间卡在 Deploying web application directory 不动
根因：Linux 熵源不足，导致 SecureRandom 初始化阻塞（物理机通常无此问题，虚拟机/云主机高发）
解决：在 bin/catalina.sh 中追加 JVM 参数：

1
JAVA_OPTS="$JAVA_OPTS -Djava.security.egd=file:/dev/./urandom"

排错黄金法则
遇到任何异常，第一反应永远是看日志：tail -200 /usr/local/tomcat/logs/catalina.out。日志中的 Caused by: 行往往直指根因，盲目重启、重装只会掩盖问题。

六、总结与下篇预告#

至此，已经完成了 Tomcat 从概念认知到实战部署的完整闭环。回顾一下，我们用一个清晰的五步流程串起了全篇：

graph LR
    A[① 安装 JDK] --> B[② 解压 Tomcat]
    B --> C[③ 修改 server.xml]
    C --> D[④ 启动 + 三重验证]
    D --> E[⑤ WAR 包部署]

    style A fill:#e1f5ff,stroke:#0288d1
    style E fill:#e8f5e9,stroke:#388e3c

6.1 本篇关键收获#

概念层：理清了 Engine / Host / Context 三级容器层级，理解了一次 HTTP 请求在 Tomcat 内部的完整旅程
操作层：掌握了 JDK 准备、标准目录结构、server.xml 核心配置、WAR 包热部署与 Manager 管理
排错层：建立了”看日志 → 查端口 → 查防火墙”的三板斧思维，五大高频问题均可独立定位

6.2 下篇预告#

本篇解决的是”跑起来”，下篇聚焦”跑得好、跑得稳”：

性能调优：JVM 堆内存参数、线程池精细化配置、连接器协议（NIO/APR）深度对比
生产架构：Nginx + Tomcat 动静分离与反向代理、单机多实例部署方案
安全加固：隐藏版本号、禁用危险 HTTP 方法、文件权限最小化实践

6.3 学习建议#

动手是最好的老师
建议在无网络环境下把本篇流程完整重做一遍（提前下载好 JDK 与 Tomcat 安装包），检验自己是否真正内化了每个步骤。学有余力者，可尝试部署开源项目 JPress 等真实 WAR 应用，巩固本节所学。遇到报错时，先运用第五章的排错思路独立解决，再对照答案——这正是运维能力成长的最短路径。