3.2 安装与配置

3.2 Apache Tomcat 安装与配置指南

核心摘要：本指南系统讲解 Apache Tomcat 9.x 的完整部署流程，涵盖下载安装、环境变量配置、server.xml/web.xml/context.xml/logging.properties 四大核心配置文件的深度调优，以及启动验证与高频故障排查。内容严格适配生产环境实践标准，兼顾 Linux/macOS 与 Windows 平台，助力开发者快速构建稳定、高性能的 Java Web 运行时环境。

1. 安装 Apache Tomcat

Apache Tomcat 是开源、轻量、符合 Jakarta EE 规范的 Servlet 容器，广泛用于部署 Spring Boot、Java Web 应用及微服务后端。其安装过程简洁，但需确保 Java 运行时环境（JRE/JDK）已就绪。

1.1 下载 Tomcat

• 访问官方下载页面：Apache Tomcat 9 Downloads
• 选择与操作系统匹配的发行包：
  • Linux/macOS：下载 .tar.gz 格式（推荐）
  • Windows：下载 .zip 格式（免安装版）
• ⚠️ 注意：Tomcat 9 要求 JDK 8 或更高版本（推荐 JDK 11/17 LTS），不兼容 JDK 18+ 的某些预览特性。

1.2 解压与目录结构

解压后生成标准目录结构，关键路径如下：

1.3 配置系统环境变量

作用：确保 Tomcat 启动时能准确定位 Java 运行时与自身安装路径。

• Linux/macOS（编辑 ~/.bashrc 或 /etc/profile）：

  export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64  # 替换为实际 JDK 路径
  export CATALINA_HOME=/opt/apache-tomcat-9.0.87         # 替换为实际 Tomcat 路径
  export PATH=$CATALINA_HOME/bin:$PATH
  ​

  执行 source ~/.bashrc 生效后验证：

  echo $JAVA_HOME && echo $CATALINA_HOME
  ​

• Windows（系统属性 → 高级 → 环境变量）：

  • 新建系统变量 JAVA_HOME：值为 JDK 安装路径（如 C:\Program Files\Java\jdk-11.0.22）
  • 新建系统变量 CATALINA_HOME：值为 Tomcat 解压目录（如 D:\apache-tomcat-9.0.87）
  • 编辑 Path 变量，追加 %CATALINA_HOME%\bin

2. 核心配置文件详解与调优

Tomcat 的行为由 conf/ 目录下四类配置文件协同控制。修改前请备份原始文件，并重启服务使配置生效。

2.1 server.xml：服务端口与连接器配置

位于 $CATALINA_HOME/conf/server.xml，定义 Tomcat 服务监听、线程模型与虚拟主机。

2.1.1 HTTP/HTTPS 端口配置

默认监听 8080，生产环境需规避冲突并启用 HTTPS：

<!-- 修改 HTTP 连接器端口（示例：改为 8081） -->
<Connector port="8081" 
           protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           maxThreads="200"
           minSpareThreads="25"
           acceptCount="100" />

<!-- 启用 HTTPS（需配置 SSL 证书） -->
<Connector port="8443" 
           protocol="org.apache.coyote.http11.Http11NioProtocol"
           maxThreads="200"
           scheme="https"
           secure="true"
           SSLEnabled="true"
           keystoreFile="${user.home}/.keystore"
           keystorePass="changeit"
           clientAuth="false"
           sslProtocol="TLS" />
​

✅ 关键参数说明：

• maxThreads：最大并发处理线程数（默认 200），高并发场景建议设为 300–500
• acceptCount：等待队列长度（默认 100），防止突发流量丢包
• redirectPort：HTTP 请求重定向至 HTTPS 的端口

2.1.2 线程池（Executor）配置

集中管理连接器线程资源，提升复用率：

<!-- 在 <Service> 标签内顶部声明线程池 -->
<Executor name="tomcatThreadPool"
          namePrefix="catalina-exec-"
          maxThreads="300"
          minSpareThreads="50"
          maxIdleTime="60000"
          prestartminSpareThreads="true" />

<!-- 在 <Connector> 中引用 -->
<Connector executor="tomcatThreadPool"
           port="8081"
           protocol="HTTP/1.1"
           ... />
​

2.2 web.xml：全局 Web 应用行为控制

位于 $CATALINA_HOME/conf/web.xml，影响所有部署应用的默认行为。

2.2.1 Servlet 与 Filter 映射

实现请求路由与横切逻辑（如日志、鉴权）：

<!-- 示例：全局字符编码过滤器（解决中文乱码） -->
<filter>
  <filter-name>CharacterEncodingFilter</filter-name>
  <filter-class>org.apache.catalina.filters.SetCharacterEncodingFilter</filter-class>
  <init-param>
    <param-name>encoding</param-name>
    <param-value>UTF-8</param-value>
  </init-param>
  <init-param>
    <param-name>forceEncoding</param-name>
    <param-value>true</param-value>
  </init-param>
</filter>
<filter-mapping>
  <filter-name>CharacterEncodingFilter</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>

<!-- 示例：禁用目录浏览（安全加固） -->
<servlet>
  <servlet-name>default</servlet-name>
  <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
  <init-param>
    <param-name>listings</param-name>
    <param-value>false</param-value> <!-- 关键：禁止文件列表 -->
  </init-param>
</servlet>
​

2.3 context.xml：应用级上下文配置

位于 $CATALINA_HOME/conf/context.xml（全局）或 webapps/your-app/META-INF/context.xml（应用级），控制数据源、会话、资源绑定。

2.3.1 数据源（DataSource）配置

集成数据库连接池（以 HikariCP 为例）：

<!-- 在 <Context> 标签内添加 -->
<Resource name="jdbc/myapp"
          auth="Container"
          type="javax.sql.DataSource"
          factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"
          driverClassName="com.mysql.cj.jdbc.Driver"
          url="jdbc:mysql://localhost:3306/mydb?useSSL=false&amp;serverTimezone=UTC"
          username="app_user"
          password="secure_password"
          maxActive="100"
          minIdle="20"
          validationQuery="SELECT 1"
          testOnBorrow="true"
          removeAbandonedOnBorrow="true"
          removeAbandonedTimeout="60" />
​

💡 提示：应用中通过 JNDI 获取 java:comp/env/jdbc/myapp 即可使用该数据源。

2.4 logging.properties：日志级别与输出控制

位于 $CATALINA_HOME/conf/logging.properties，采用 Java Util Logging（JUL）框架。

2.4.1 生产环境日志策略

# 全局日志级别（INFO 以上输出）
.level = INFO

# 降低 catalina 日志冗余度，聚焦错误
org.apache.catalina.core.ContainerBase.[Catalina].[localhost].level = WARNING
org.apache.catalina.core.ContainerBase.[Catalina].[localhost].handlers = java.util.logging.ConsoleHandler

# 启用访问日志（需在 server.xml 中配置 AccessLogValve）
1catalina.org.apache.juli.AsyncFileHandler.level = FINE
1catalina.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs
1catalina.org.apache.juli.AsyncFileHandler.prefix = catalina.

# 自定义应用日志（示例：com.example 包下 DEBUG 级别）
com.example.level = DEBUG
​

3. 启动、验证与健康检查

3.1 启动服务

• Linux/macOS：

  cd $CATALINA_HOME/bin
  ./startup.sh
  # 或后台运行：nohup ./catalina.sh start &
  ​

• Windows：双击 startup.bat，或命令行执行 startup.bat

3.2 验证运行状态

• 检查进程：ps aux | grep tomcat（Linux/macOS）或任务管理器（Windows）
• 查看日志：实时监控 logs/catalina.out
• 访问控制台：http://localhost:8081（端口按配置调整）→ 显示 Tomcat 欢迎页即成功
• 检查端口占用：netstat -an | grep 8081 或 lsof -i :8081

3.3 停止服务

# Linux/macOS
$CATALINA_HOME/bin/shutdown.sh

# Windows
$CATALINA_HOME/bin/shutdown.bat
​

⚠️ 注意：强制终止进程（kill -9）可能导致工作目录残留锁文件，下次启动失败。

4. 高频问题诊断与解决方案

5. 安全加固建议（生产必备）

• 禁用管理界面：删除 webapps/manager 和 webapps/host-manager 目录，或在 conf/tomcat-users.xml 中移除 manager-gui/admin-gui 角色
• 最小化权限：以非 root 用户运行 Tomcat（Linux/macOS），避免 bin/ 目录写权限
• 隐藏版本号：在 conf/web.xml 中添加 <context-param><param-name>org.apache.catalina.STRICT_SERVLET_COMPLIANCE</param-name><param-value>true</param-value></context-param>，并在 conf/server.xml 的 Connector 中添加 server="Apache"
• 启用 HTTPS：通过 Let’s Encrypt 或商业证书配置 TLS，禁用 HTTP 明文传输

结语
Apache Tomcat 的安装与配置是 Java Web 应用部署的基石。本文覆盖从环境准备、核心配置调优到故障排查的全生命周期，强调生产就绪（Production-Ready）实践——包括线程池优化、日志分级、安全加固与内存管理。遵循本指南配置的 Tomcat 实例，可稳定承载中高并发业务，同时为后续集成 Spring Cloud、Dubbo 等微服务框架提供坚实运行时支撑。建议将配置文件纳入版本管理，并结合 Ansible 或 Docker 实现配置即代码（Infrastructure as Code）。