根本原因是CATALINA_HOME与CATALINA_BASE指向同一目录，或启动脚本未实际读取所设环境变量；Linux需在同shell中export后直接运行startup.sh，Windows需在调用startup.bat前set且不可双击图形启动。
为什么设置 CATALINA_BASE 后 Tomcat 仍启动默认实例？
根本原因通常是 CATALINA_HOME 和 CATALINA_BASE 指向了同一目录，或启动脚本未实际读取你设的环境变量。Tomcat 启动时优先检查当前 shell 环境中的变量，但 Windows 的 startup.bat 和 Linux 的 startup.sh 都会在内部重置或覆盖部分变量。
- Linux 下用
export CATALINA_BASE=/opt/tomcat-instance-a后，必须在同个 shell 中直接运行./bin/startup.sh，不能新开终端或用sudo（会丢失环境） - Windows 下
set CATALINA_BASE=C:\tomcat-prod必须在调用startup.bat前执行，且不能写在系统级环境变量里再双击启动——图形界面启动不继承 cmd 设置 - 验证是否生效：启动后查看日志头几行，
INFO [main] org.apache.catalina.startup.VersionLoggerListener.log Server home: ...这里的 “Server home” 是CATALINA_HOME，“Base home” 才是CATALINA_BASE
CATALINA_BASE 目录结构必须包含哪些子目录？
Tomcat 不会自动创建缺失目录，只校验关键路径是否存在。若缺少任一必需目录，会静默回退到 CATALINA_HOME，甚至报 java.lang.IllegalArgumentException: Document base does not exist。
- 必须存在：
conf/（含server.xml）、logs/、webapps/、work/、temp/ -
conf/是硬性要求，哪怕只放一个空server.xml（内容可极简，但格式要合法） -
work/和temp/可为空，但目录本身必须存在且有写权限；否则 JSP 编译或临时文件操作失败 - 推荐用
cp -r $CATALINA_HOME/conf $CATALINA_BASE/复制后再修改，避免遗漏logging.properties或context.xml
多个实例共用 CATALINA_HOME 时，server.xml 端口冲突怎么查？
每个 CATALINA_BASE 实例的 conf/server.xml 必须独立配置端口，否则第二个实例启动时会卡在 Starting ProtocolHandler 并最终超时失败，错误日志里不会直接说“端口被占”，而是 SEVERE [main] org.apache.catalina.util.LifecycleBase.handleSubClassException Failed to start component [StandardServer[8005]] —— 其中 8005 是 shutdown 端口，默认值。
- 检查三类端口：shutdown（
<Server port="8005">）、HTTP connector（<Connector port="8080">）、AJP（<Connector port="8009">） - Linux 下快速检测：启动前执行
ss -tuln | grep ':8080\|:8005'；Windows 用netstat -ano | findstr :8080 - 不要复用
conf/web.xml或conf/context.xml的全局配置，它们影响所有 WebApp 行为，比如 session timeout 或 resource linking
用 systemd 或 Windows Service 安装多实例时，CATALINA_BASE 怎么固化？
服务管理器启动进程时通常不加载用户 shell 环境变量，所以靠 export 或 set 设置的 CATALINA_BASE 无效。必须显式注入。
- Linux systemd：在 service 文件的
[Service]段加Environment="CATALINA_BASE=/opt/tomcat-app1"，并确保Type=forking且PIDFile指向该实例的work/catalina.pid - Windows Service（
service.bat install）：安装前先运行set CATALINA_BASE=C:\tomcat-app2，再执行service.bat install MyApp2；后续修改需用tomcatXw.exeGUI 工具重新配置 Environment 页签 - 注意：Windows Service 默认把
CATALINA_HOME写死为安装时的路径，改CATALINA_BASE不影响它，但两个变量不能交叉指向对方子目录，否则解压 WAR 时可能误删共享资源
conf/ 后，server.xml 里的 appBase 属性（如 <Host appBase="webapps" ...>）仍是相对路径，它相对于 CATALINA_BASE 解析，不是 CATALINA_HOME。如果忘了同步调整，新实例可能去读错的 webapps 目录。 
