Linux 环境下 Tomcat 安装部署全指南：指定版本安装、Docker 容器化对比与高频避坑实战

📌 什么是 Tomcat？#

Apache Tomcat 是由 Apache 软件基金会（ASF）开发维护的开源 Java Servlet 容器与 Web 服务器。作为 Java EE / Jakarta EE 规范的核心实现之一，Tomcat 完整支持 Servlet、JSP（JavaServer Pages）、EL 表达式以及 WebSocket 技术。

凭借其轻量、高效、稳定、高度可定制以及完全开源免费的特性，Tomcat 长期作为中小型 Java Web 应用、企业级系统与 Spring Boot 内嵌 Web 容器的首选运行环境。

🛠️ 一、Linux 系统中安装指定版本 Tomcat#

Tomcat 属于纯 Java 应用，其运行严格依赖 JDK 环境。在部署前，务必先确定目标 Tomcat 版本与 JDK 版本的兼容矩阵：

Tomcat 版本	支持的 Servlet 规范	命名空间	推荐最低 JDK 版本
Tomcat 8.5.x	Servlet 3.1	`javax.servlet`	JDK 7 / 8
Tomcat 9.0.x	Servlet 4.0	`javax.servlet`	JDK 8+
Tomcat 10.1.x	Servlet 6.0	`jakarta.servlet`	JDK 11+ (推荐 JDK 17/21)
Tomcat 11.0.x	Servlet 6.1	`jakarta.servlet`	JDK 17+ (推荐 JDK 21)

IMPORTANT
关键差异提示：Tomcat 10+ 开始全面迁移至 Jakarta EE 规范，包名从 javax.* 变更为 jakarta.*。旧版 Spring MVC / Java Web 项目如果直接部署在 Tomcat 10+ 上会抛出 ClassNotFoundException: javax.servlet.*。

步骤 1：安装前置 JDK 环境并配置 `JAVA_HOME`#

无论使用哪种 Tomcat 部署方式，宿主机均需安装对应版本的 JDK（以 OpenJDK 17 为例）：

1
# 1. 更新包索引并安装
2
sudo apt update
3
sudo apt install -y openjdk-17-jdk
4

5
# 2. 验证基础命令
6
java -version

1
# 1. 安装 OpenJDK 17 开发套件（含 javac 工具）
2
sudo yum install -y java-17-openjdk-devel
3

4
# 2. 验证基础命令
5
java -version

❓ 疑问解答：通过 yum/apt 安装后需要配置环境变量吗？#

普通命令行：包管理器会自动在 /usr/bin/ 建立 java 软链接，因此直接执行 java -version 即可生效，不需要手动在 PATH 中追加。
Tomcat 生产运行：强烈建议配置 JAVA_HOME！Tomcat 的 startup.sh / catalina.sh 会优先查找 $JAVA_HOME 变量。如果不显式配置，在多版本 JDK 并存或 systemd 托管环境下极易报 Neither the JAVA_HOME nor the JRE_HOME environment variable is defined 错误。

🔍 如何准确找到 JDK 的真实安装路径？#

不同 Linux 发行版与架构下的 JDK 安装路径略有不同，可使用以下命令精准获取：

1
# 方法 A：通过 alternatives 追溯真实软链接目标
2
ls -l $(which java)
3
# 或执行：
4
readlink -f $(which java)
5
# openEuler/CentOS 通常输出：/usr/lib/jvm/java-17-openjdk-17.0.19.10-7.oe2403sp4.x86_64/bin/java
6
# 则 JAVA_HOME 去掉最后的 /bin/java，即为：/usr/lib/jvm/java-17-openjdk（系统通常会提供一个不带具体补丁小版本的通用软链接目录）
7

8
# 方法 B：查看系统所有注册的 Java 环境
9
alternatives --display java

写入全局环境变量（推荐）：#

1
# 写入 profile.d 独立环境配置文件
2
sudo tee /etc/profile.d/java.sh << 'EOF'
3
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
4
export PATH=$JAVA_HOME/bin:$PATH
5
export CLASSPATH=.:$JAVA_HOME/lib
6
EOF
7

8
# 立即刷新环境变量
9
source /etc/profile.d/java.sh
10

11
# 验证 JAVA_HOME 是否正确输出
12
echo $JAVA_HOME

步骤 2：下载并解压指定版本 Tomcat#

通过 Apache 官方归档源下载稳定版本（以 Tomcat 9.0.86 为例，如需 Tomcat 10 请替换对应版本号）：

1
# 1. 创建统一软件目录
2
sudo mkdir -p /opt/tomcat
3

4
# 2. 下载 Tomcat 9 二进制包
5
wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.86/bin/apache-tomcat-9.0.86.tar.gz
6

7
# 3. 解压并规范重命名
8
sudo tar -zxvf apache-tomcat-9.0.86.tar.gz -C /opt/tomcat/
9
sudo mv /opt/tomcat/apache-tomcat-9.0.86 /opt/tomcat/tomcat9
10

11
# 4. 创建专用 pid 与临时目录
12
sudo mkdir -p /opt/tomcat/tomcat9/temp

步骤 3：创建专用运行用户与目录提权#

生产环境中严禁使用 root 用户直接运行 Web 容器，以防被利用后沦陷整机：

1
# 1. 创建不可登录的 tomcat 系统用户与用户组
2
sudo groupadd tomcat
3
sudo useradd -s /bin/false -g tomcat -d /opt/tomcat/tomcat9 tomcat
4

5
# 2. 赋予目录归属与脚本执行权限
6
sudo chown -R tomcat:tomcat /opt/tomcat/tomcat9
7
sudo chmod +x /opt/tomcat/tomcat9/bin/*.sh

步骤 4：标准化配置 `bin/setenv.sh`（推荐实践）#

Tomcat 官方推荐将 JVM 参数、内存分配、字符编码独立维护在 bin/setenv.sh 中，无需侵入修改 catalina.sh：

1
sudo tee /opt/tomcat/tomcat9/bin/setenv.sh << 'EOF'
2
#!/bin/bash
3
# JDK 环境变量绑定
4
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
5
export JRE_HOME=$JAVA_HOME
6

7
# 进程 PID 记录文件（便于精准终止）
8
export CATALINA_PID=/opt/tomcat/tomcat9/temp/tomcat.pid
9

10
# JVM 内存与垃圾回收器调优（根据服务器配置调整，建议初始 512M 最大 1024M）
11
export CATALINA_OPTS="-Xms512m -Xmx1024m -XX:+UseG1GC -server"
12

13
# 解决中文乱码与防启动卡顿熵池配置
14
export JAVA_OPTS="-Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -Djava.security.egd=file:/dev/./urandom -Djava.awt.headless=true"
15
EOF
16

17
# 赋予执行权限与归属
18
sudo chmod +x /opt/tomcat/tomcat9/bin/setenv.sh
19
sudo chown tomcat:tomcat /opt/tomcat/tomcat9/bin/setenv.sh

步骤 5：配置 Systemd 系统守护进程服务#

创建系统服务管理文件 /etc/systemd/system/tomcat.service：

1
[Unit]
2
Description=Apache Tomcat Web Application Container
3
After=network.target
4

5
[Service]
6
Type=forking
7

8
User=tomcat
9
Group=tomcat
10

11
Environment="JAVA_HOME=/usr/lib/jvm/java-17-openjdk"
12
Environment="CATALINA_PID=/opt/tomcat/tomcat9/temp/tomcat.pid"
13
Environment="CATALINA_HOME=/opt/tomcat/tomcat9"
14
Environment="CATALINA_BASE=/opt/tomcat/tomcat9"
15

16
ExecStart=/opt/tomcat/tomcat9/bin/startup.sh
17
ExecStop=/opt/tomcat/tomcat9/bin/shutdown.sh 10 -force
18

19
RestartSec=10
20
Restart=always
21

22
[Install]
23
WantedBy=multi-user.target

步骤 6：配置 Linux 防火墙与云安全组（解决无法访问的关键）#

在外部浏览器访问 http://服务器IP:8080 前，必须确保本地防火墙和云厂商安全组均已放行 8080 端口：

1. Linux 本机防火墙放行#

1
# 1. 检查防火墙是否在运行
2
sudo systemctl status firewalld
3

4
# 2. 永久开放 TCP 8080 端口
5
sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent
6

7
# 3. 重新加载规则使其立即生效
8
sudo firewall-cmd --reload
9

10
# 4. 验证端口是否已成功放行
11
sudo firewall-cmd --query-port=8080/tcp
12
# 输出 yes 即表示放行成功

1
# 开放 8080 端口
2
sudo ufw allow 8080/tcp
3
sudo ufw reload

2. 云服务器安全组配置（必查！）#

若服务器部署在阿里云、腾讯云、华为云、AWS、腾讯云轻量等云平台，系统内置防火墙放行后，还必须在云控制台安全组入方向规则中添加一条放行规则：

协议类型：TCP
端口范围：8080
授权对象/源 IP：0.0.0.0/0（全网开放）或指定你的客户端公网 IP。

步骤 7：启动服务与全链路验证#

1
# 1. 重新加载 systemd 配置
2
sudo systemctl daemon-reload
3

4
# 2. 启动 Tomcat 服务
5
sudo systemctl start tomcat
6

7
# 3. 设置开机自启
8
sudo systemctl enable tomcat
9

10
# 4. 检查服务运行状态（Active: active (running) 说明成功）
11
sudo systemctl status tomcat
12

13
# 5. 本地终端测试 HTTP 连通性
14
curl -I http://127.0.0.1:8080
15
# 正常应返回 HTTP/1.1 200 或 302

📋 二、Tomcat 日志体系与日常查看排查#

Tomcat 的全部运行与访问日志存放在 $CATALINA_HOME/logs/ 目录下（本文路径为 /opt/tomcat/tomcat9/logs/）：

日志文件名	记录内容与定位场景
`catalina.out`	核心控制台标准输出：包含 JVM 启动日志、未捕获异常堆栈、应用中 `System.out.println` 输出等，排错首选。
`catalina.YYYY-MM-DD.log`	Tomcat 容器自身引擎与组件生命周期日志。
`localhost.YYYY-MM-DD.log`	Web 应用程序 Context 初始化、Filter 加载及 Servlet 运行异常。
`localhost_access_log.YYYY-MM-DD.txt`	HTTP 访问请求日志：记录客户端来源 IP、访问时间、请求路径、HTTP 状态码及耗时。

常用日志排查命令：#

1
cd /opt/tomcat/tomcat9/logs
2

3
# 1. 实时跟踪控制台最新日志输出（启动/报错联调最常用）
4
tail -f catalina.out
5

6
# 2. 查看最近 200 行日志并支持滚动翻页
7
tail -n 200 catalina.out | less
8

9
# 3. 在日志中检索致命错误或异常堆栈（忽略大小写）
10
grep -in -C 5 "exception\|error" catalina.out
11

12
# 4. 查看今天的 HTTP 请求访问记录
13
tail -f localhost_access_log.$(date +%F).txt

🔍 三、服务无法访问？5 步漏斗排查指南#

如果在浏览器输入 http://<服务器IP>:8080 出现无法连接、超时或报错，请按照以下标准顺序逐步排查：

1
flowchart TD
2
    A[外部浏览器无法访问 8080] --> B[第 1 步：检查 Tomcat 进程状态]
3
    B -- 进程不存在/挂掉 --> B1[查看 logs/catalina.out 启动报错]
4
    B -- 正常 active running --> C[第 2 步：检查 8080 端口监听]
5
    C -- 8080 未监听 --> C1[检查 conf/server.xml 配置与端口冲突]
6
    C -- 8080 正在监听 --> D[第 3 步：本地回环测试 curl]
7
    D -- 报 404/500 --> D1[检查 webapps 部署目录及 ROOT 项目]
8
    D -- 正常响应 200 --> E[第 4 步：检查 Linux 系统防火墙]
9
    E -- 端口未放行 --> E1[执行 firewall-cmd 放行 8080]
10
    E -- 本机防火墙已放行 --> F[第 5 步：检查云厂商安全组/公网路由]

1
# 第 1 步：检查进程与服务状态
2
sudo systemctl status tomcat
3
# 或直接看 Java 进程
4
ps -ef | grep tomcat
5

6
# 第 2 步：查看 8080 端口是否正处于 LISTEN 监听状态
7
sudo ss -tulpn | grep 8080
8
# 正常应显示类似：LISTEN  0  100  *:8080  *:*  users:(("java",pid=...,fd=...))
9

10
# 第 3 步：在服务器内部测试本机能否连通
11
curl -I http://127.0.0.1:8080
12

13
# 第 4 步：检查防火墙规则是否真正生效
14
sudo firewall-cmd --list-ports
15

16
# 第 5 步：如果开启了 SELinux，可临时排查是否被策略拦截
17
getenforce
18
# 若为 Enforcing 且怀疑被拦截，可临时测试：
19
sudo setenforce 0

🐳 四、Linux 下使用 Docker 快速部署 Tomcat#

使用 Docker 可以在同一台机器上秒级运行任意特定版本（如 Tomcat 8.5、9.0、10.1），彻底免去宿主机配置多版本 JDK 的繁琐流程。

1. `docker run` 单行命令运行#

1
docker run -d \
2
  --name tomcat-server \
3
  -p 8080:8080 \
4
  -v /opt/tomcat_docker/webapps:/usr/local/tomcat/webapps \
5
  -v /opt/tomcat_docker/logs:/usr/local/tomcat/logs \
6
  -v /opt/tomcat_docker/conf:/usr/local/tomcat/conf \
7
  -e TZ=Asia/Shanghai \
8
  -e JAVA_OPTS="-Xms512m -Xmx1024m -Dfile.encoding=UTF-8" \
9
  --restart unless-stopped \
10
  tomcat:9.0-jdk17-corretto

2. `docker-compose.yml` 规范化编排#

在部署目录下创建 docker-compose.yml：

1
version: '3.8'
2

3
services:
4
  tomcat:
5
    image: tomcat:9.0-jdk17-corretto
6
    container_name: tomcat-app
7
    restart: always
8
    environment:
9
      TZ: Asia/Shanghai
10
      JAVA_OPTS: "-Xms1024m -Xmx2048m -XX:+UseG1GC -Dfile.encoding=UTF-8"
11
    ports:
12
      - "8080:8080"
13
    volumes:
14
      - ./webapps:/usr/local/tomcat/webapps
15
      - ./conf/server.xml:/usr/local/tomcat/conf/server.xml
16
      - ./logs:/usr/local/tomcat/logs

管理命令：

1
# 启动
2
docker compose up -d
3

4
# 查看实时日志
5
docker compose logs -f

⚖️ 五、Docker 部署 vs 传统宿主机部署优劣对比#

评估维度	Docker 容器化部署	传统宿主机/裸机部署 (Systemd 托管)
JDK 版本隔离	🌟 完全解耦，镜像内置对应 JDK，无需在宿主机配置复杂环境变量	⚠️ 宿主机若运行多个不同 JDK 版本的 Java 项目易发生 `JAVA_HOME` 污染
启动与交付效率	⚡ 秒级交付，将 WAR 包直接打包入镜像或挂载即可跨环境无缝运行	⏳ 需配置前置环境，需手动安装 JDK、配置目录权限和 Systemd 脚本
多实例与端口映射	🌟 极其简单，容器内均使用 8080 端口，宿主机只需映射不同端口	⚠️ 需复制多份 Tomcat 目录，修改各自 `server.xml` 中的 3 个端口（8005/8080/8009）
JVM 性能与资源上限	损耗微乎其微（< 1%），支持 `cgroups` 精确限制 CPU 与内存上限	🚀 原生运行，可直接利用宿主机所有硬件特性与线程调度
日志与排查便捷度	可通过 `docker logs` 统一采集，配合 ELK 或 Promtail 更轻松	🛠️ 直接在 `/opt/tomcat/logs/` 查阅 `catalina.out`，原生 GDB / jstack 排查更直接

NOTE
选型决策参考：

微服务交付、CI/CD 自动化流水线、测试环境：首选 Docker，实现构建产物与运行时一体化分发。

单体遗留架构、需复杂本地 JNI 库依赖或需要本地频繁 JStack/JMap 诊断的超大内存服务：可采用 宿主机 Systemd 部署。

⚠️ 六、新手最容易犯错的关键坑点与解决方案#

💣 坑点 1：Docker 官方 Tomcat 镜像启动后访问报 404 错误#

现象#

使用 Docker 运行 tomcat:latest 或 tomcat:9 后，浏览器打开 http://IP:8080 提示 HTTP Status 404 – Not Found。

核心原因#

Docker 官方为了精简镜像体积，在较新版本镜像中将原本的默认示例页面目录重命名为 webapps.dist，而新建的 webapps 目录为空。

解决方案#

进入容器将 webapps.dist 里的内容拷贝回 webapps：

1
# 进入容器
2
docker exec -it tomcat-server bash
3

4
# 将预置文件复制到 webapps 目录
5
cp -r /usr/local/tomcat/webapps.dist/* /usr/local/tomcat/webapps/

💣 坑点 2：Tomcat 10+ 部署旧项目报错 ClassNotFoundException: javax.servlet.*#

现象#

将旧项目的 WAR 包部署到 Tomcat 10.x 或 11.x 后启动崩溃，报类找不到错误：java.lang.ClassNotFoundException: javax.servlet.Filter。

核心原因#

Tomcat 10+ 全面切换至 Jakarta EE 9+ 体系，包名全面变更为 jakarta.servlet.*，与 Java EE 8 之前的 javax.servlet.* 不兼容。

解决方案#

方案 A（推荐）：降级使用 Tomcat 9.0.x（继续支持 javax.servlet）。
方案 B：使用 Apache 官方提供的迁移工具 Tomcat Migration Tool for Jakarta EE 进行字节码自动转换：
系统终端
```
1
java -jar jakartaee-migration-*.jar old_app.war new_app.war
```

💣 坑点 3：日志与控制台中文输出乱码（??? 或涓枃）#

现象#

在 catalina.out 或控制台日志中，中文字符显示为乱码或问号。

核心原因#

Linux 系统的 LANG 编码、Tomcat 自身的 file.encoding 以及 server.xml 中的 URI 编码未对齐。

解决方案#

修改 bin/catalina.sh 添加 UTF-8 参数：

1
JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8"

修改 conf/server.xml 中的 Connector 节点，显式声明 URIEncoding="UTF-8"：

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

💣 坑点 4：服务关闭时报 java.lang.OutOfMemoryError 且进程残留（内存泄露）#

现象#

执行 shutdown.sh 后，日志抛出 The web application [xxx] appears to have started a thread named [xxx] but has failed to stop it. This is very likely to create a memory leak.，且 ps -ef | grep tomcat 发现进程根本没有退出。

核心原因#

Web 应用中存在未正确注销的线程（如 Timer、线程池、JDBC 驱动守护线程），导致 JVM 拒绝正常终止。

解决方案#

在 Systemd 服务或脚本中增加强制停止参数：在 catalina.sh 中配置 CATALINA_PID，并在停止时调用 -force：
bin/catalina.sh
```
1
CATALINA_PID=/opt/tomcat/tomcat9/temp/tomcat.pid
```
停止命令改为：
系统终端
```
1
/opt/tomcat/tomcat9/bin/shutdown.sh 5 -force
```

💣 坑点 5：Tomcat 启动极慢（卡在 At least one JAR was scanned…）#

现象#

Tomcat 启动耗时多达数分钟，日志停滞在：Creation of SecureRandom instance for session ID generation using [SHA1PRNG] took [xxx] milliseconds.。

核心原因#

Linux 的 /dev/random 在熵池不足时会阻塞，导致生成 Session ID 的安全随机数生成器挂起。

解决方案#

在 catalina.sh 的 JAVA_OPTS 中将阻塞的 /dev/random 替换为非阻塞的 /dev/urandom：

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

⚙️ 七、生产环境通用优化配置模板（`server.xml`）#

一份优化过连接器并发、禁用 AJP 漏洞端口并隐藏敏感版本的生产配置：

1
<?xml version="1.0" encoding="UTF-8"?>
2
<Server port="8005" shutdown="SHUTDOWN_SECRET_TOKEN">
3
  <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
4
  <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
5
  <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
6
  <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
7
  <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />
8

9
  <Service name="Catalina">
10
    <!-- 高性能 NIO 连接器配置 -->
11
    <Connector port="8080"
12
               protocol="org.apache.coyote.http11.Http11NioProtocol"
13
               connectionTimeout="20000"
14
               redirectPort="8443"
15
               maxThreads="500"
16
               minSpareThreads="50"
17
               acceptCount="200"
18
               maxConnections="10000"
19
               enableLookups="false"
20
               URIEncoding="UTF-8"
21
               server="Web Server"
22
               compression="on"
23
               compressionMinSize="2048"
24
               compressableMimeType="text/html,text/xml,text/plain,text/css,text/javascript,application/javascript,application/json" />
25

26
    <!-- 生产环境若不使用 Apache 反代，务必注释掉默认开放的 8009 AJP 端口以避免 Ghostcat 漏洞 -->
27
    <!-- <Connector protocol="AJP/1.3" port="8009" redirectPort="8443" /> -->
28

29
    <Engine name="Catalina" defaultHost="localhost">
30
      <Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="false">
31
        <!-- 访问日志配置 -->
32
        <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
33
               prefix="localhost_access_log" suffix=".txt"
34
               pattern="%h %l %u %t &quot;%r&quot; %s %b %D" />
35
      </Host>
36
    </Engine>
37
  </Service>
38
</Server>

🎯 八、总结速查#

版本匹配：
- 传统 Java EE 8 / javax.* 项目首选 Tomcat 9.0.x。
- 新一代 Jakarta EE 10+ / Spring Boot 3+ 项目采用 Tomcat 10.1.x / 11.0.x。
生产上线避坑清单：
- 确认 JDK 版本与 Tomcat 版本矩阵匹配；
- 在 JAVA_OPTS 中配置 -Dfile.encoding=UTF-8 与 -Djava.security.egd=file:/dev/./urandom；
- 针对物理内存配置合理 JVM 堆大小（-Xms、-Xmx）并启用 G1 垃圾收集器；
- 注释未使用的 8009 AJP 端口，防范网络安全风险；
- 生产环境建议关闭 autoDeploy="false"，避免运行时频繁热扫描消耗 CPU。

📌 什么是 Tomcat？#

🛠️ 一、Linux 系统中安装指定版本 Tomcat#

步骤 1：安装前置 JDK 环境并配置 JAVA_HOME#

❓ 疑问解答：通过 yum/apt 安装后需要配置环境变量吗？#

🔍 如何准确找到 JDK 的真实安装路径？#

写入全局环境变量（推荐）：#

步骤 2：下载并解压指定版本 Tomcat#

步骤 3：创建专用运行用户与目录提权#

步骤 4：标准化配置 bin/setenv.sh（推荐实践）#

步骤 5：配置 Systemd 系统守护进程服务#

步骤 6：配置 Linux 防火墙与云安全组（解决无法访问的关键）#

1. Linux 本机防火墙放行#

2. 云服务器安全组配置（必查！）#

步骤 7：启动服务与全链路验证#

📋 二、Tomcat 日志体系与日常查看排查#

常用日志排查命令：#

🔍 三、服务无法访问？5 步漏斗排查指南#

🐳 四、Linux 下使用 Docker 快速部署 Tomcat#

1. docker run 单行命令运行#

2. docker-compose.yml 规范化编排#

⚖️ 五、Docker 部署 vs 传统宿主机部署优劣对比#

⚠️ 六、新手最容易犯错的关键坑点与解决方案#

💣 坑点 1：Docker 官方 Tomcat 镜像启动后访问报 404 错误#

现象#

核心原因#

解决方案#

💣 坑点 2：Tomcat 10+ 部署旧项目报错 ClassNotFoundException: javax.servlet.*#

现象#

核心原因#

解决方案#

💣 坑点 3：日志与控制台中文输出乱码（??? 或 涓枃）#

现象#

核心原因#

解决方案#

💣 坑点 4：服务关闭时报 java.lang.OutOfMemoryError 且进程残留（内存泄露）#

现象#

核心原因#

解决方案#

💣 坑点 5：Tomcat 启动极慢（卡在 At least one JAR was scanned…）#

现象#

核心原因#

解决方案#

⚙️ 七、生产环境通用优化配置模板（server.xml）#

🎯 八、总结速查#

发现新文章

步骤 1：安装前置 JDK 环境并配置 `JAVA_HOME`#

步骤 4：标准化配置 `bin/setenv.sh`（推荐实践）#

1. `docker run` 单行命令运行#

2. `docker-compose.yml` 规范化编排#

💣 坑点 3：日志与控制台中文输出乱码（??? 或涓枃）#

⚙️ 七、生产环境通用优化配置模板（`server.xml`）#