Tomcat配置CATALINA_BASE环境变量法-java教程-PHP中文网

根本原因是catalina_home与catalina_base指向同一目录，或启动脚本未实际读取所设环境变量；linux需在同shell中export后直接运行startup.sh，windows需在调用startup.bat前set且不可双击图形启动。

tomcat配置catalina_base环境变量法

为什么设置 `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。

阿里云AI平台

阿里云AI平台是一款面向企业和开发者的云端人工智能服务平台。

下载

必须存在：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"></server>）、HTTP connector（<connector port="8080"></connector>）、AJP（<connector port="8009"></connector>）
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.exe GUI 工具重新配置 Environment 页签
注意：Windows Service 默认把 CATALINA_HOME 写死为安装时的路径，改 CATALINA_BASE 不影响它，但两个变量不能交叉指向对方子目录，否则解压 WAR 时可能误删共享资源

真正容易被忽略的是：每次复制 conf/ 后，server.xml 里的 appBase 属性（如 <host appbase="webapps" ...></host>）仍是相对路径，它相对于 CATALINA_BASE 解析，不是 CATALINA_HOME。如果忘了同步调整，新实例可能去读错的 webapps 目录。