每个Tomcat实例必须配置独立的CATALINA_BASE(必需)和推荐独立的CATALINA_HOME,否则会因日志混写、work目录冲突、webapps误删等导致启动失败或异常;CATALINA_BASE决定conf、logs、temp、webapps、work路径,不可共用。

配置 Tomcat 集群时,环境变量不是“统一配一套就行”,而是每个实例必须有独立的 CATALINA_BASE 和(可选但推荐的)独立 CATALINA_HOME,否则多个实例会争抢日志、临时文件、工作目录,直接导致启动失败或行为异常。
为什么不能共用 CATALINA_BASE
CATALINA_BASE 决定 Tomcat 实例的运行时根目录:它指向 conf、logs、temp、webapps、work 这些关键子目录的实际位置。如果两个实例共用同一个 CATALINA_BASE:
- 修改一个实例的
server.xml会同时影响另一个 - 两个实例的日志会混写进同一份
catalina.out,无法区分来源 -
work目录下的 JSP 编译类会互相覆盖,引发ClassCastException或 500 错误 - 部署在
webapps下的应用可能被另一个实例意外删掉或重载
正确设置 CATALINA_BASE 和 CATALINA_HOME
以双实例为例(tomcat1 和 tomcat2),假设解压路径分别为 C:\tomcat1 和 C:\tomcat2:
-
CATALINA_HOME可指向各自解压根目录(推荐),也可共用一个只读的安装包(如C:\tomcat-common),但必须确保该目录不被任何实例写入 -
CATALINA_BASE必须各自独立,且值必须是完整绝对路径(不能含变量引用嵌套,如%CATALINA_HOME%_2) - Windows 上需新建两个系统变量:
CATALINA_BASE_1 = C:\tomcat1、CATALINA_BASE_2 = C:\tomcat2;Linux 上则在~/.bashrc中分别定义 - 不要设
TOMCAT_HOME—— 它不是 Tomcat 官方识别的变量,纯属冗余,还可能干扰脚本逻辑
修改 bin 目录下脚本以支持多实例
Tomcat 自带的 startup.bat、shutdown.bat、catalina.bat 默认只认 CATALINA_BASE 和 CATALINA_HOME 环境变量。要让第二个实例走自己的路径,必须显式改写脚本:
- 复制一份
catalina.bat改名为catalina2.bat,开头插入:set CATALINA_BASE=C:\tomcat2 set CATALINA_HOME=C:\tomcat2
- 复制
startup.bat为startup2.bat,把最后一行call "%CATALINA_HOME%\bin\catalina.bat" start %CMD_LINE_ARGS%改成call "%CATALINA_HOME%\bin\catalina2.bat" start %CMD_LINE_ARGS% - Linux 类似,改
catalina.sh开头的export CATALINA_BASE=...,并确保调用的是对应脚本 - 切勿直接在全局环境变量里来回切换
CATALINA_BASE——这会导致命令行窗口状态污染,极易出错
验证是否真正隔离成功
启动两个实例后,立刻检查以下三点,比看页面更早暴露问题:
- 分别进入两个
logs目录,确认catalina.out文件时间戳和内容互不重叠 - 执行
netstat -ano | findstr :8080和netstat -ano | findstr :9080(假设第二实例改了端口),确认 PID 不同且各自监听正确端口 - 访问
http://localhost:8080/manager/status和http://localhost:9080/manager/status,核对页面顶部显示的 “Server info” 中的catalina.base路径是否与你设定的一致
最容易被忽略的是:CATALINA_BASE 指向的目录下必须包含完整的 conf 子目录(哪怕只是从 CATALINA_HOME/conf 复制过来),否则 Tomcat 启动时会静默失败,连日志都不写——因为连最基本的 logging.properties 都找不到。

















