catalina_home必须指向tomcat根目录（如d:\apache-tomcat-9.0.69），而非bin子目录；java_home须指向jdk根目录且路径含空格时需加引号；环境变量修改后需新开终端验证，多实例应避免全局catalina_home。
CATALINA_HOME 指向了 bin 目录而不是根目录
这是最典型的配置错误。Tomcat 启动脚本（startup.bat 或 catalina.sh）会检查 CATALINA_HOME 是否指向 Tomcat 安装根目录（含 bin、conf、lib 等子目录），如果值是 D:\apache-tomcat-9.0.69\bin，脚本会直接报错：The CATALINA_HOME environment variable is not defined correctly。
- 正确路径示例：
D:\apache-tomcat-9.0.69（Windows）或/opt/tomcat（Linux） - 错误路径示例：
D:\apache-tomcat-9.0.69\bin、/opt/tomcat/bin、末尾带斜杠如/opt/tomcat/（部分旧版脚本对尾部斜杠敏感） - 验证方式：在新终端中执行
echo %CATALINA_HOME%（Windows）或echo $CATALINA_HOME（Linux/macOS），输出必须是干净的根路径
JAVA_HOME 指向 JRE 而非 JDK，或路径含空格未加引号
Tomcat 启动时调用 java 命令，依赖 JAVA_HOME 下的 bin/java。若该变量指向 JRE（如 C:\Program Files\Java\jre1.8.0_301），会提示 Unable to locate tools.jar 或直接闪退；若路径含空格（如 C:\Program Files\Java\jdk-17）且未在脚本中用引号包裹，catalina.bat 会把空格后内容误判为参数。
- 必须确保
JAVA_HOME指向 JDK 根目录（含lib/tools.jar或 JDK 11+ 的lib/jdk.javadoc.jar等） - Windows 下若路径含空格，在
setclasspath.bat中需确认if not "%JAVA_HOME%" == "" goto gotJdkHome后的逻辑是否加了双引号，例如："%JAVA_HOME%\bin\java" - Linux/macOS 下建议在
~/.bashrc中写成：export JAVA_HOME="/usr/lib/jvm/java-17-openjdk-amd64"（引号可选但推荐）
环境变量配置后未生效，或被多个 Tomcat 实例干扰
Windows 上修改系统环境变量后，已打开的命令行窗口不会自动继承新值；Linux/macOS 中未执行 source ~/.bashrc 也会导致失效。更隐蔽的问题是：机器上存在多个 Tomcat 安装，而 CATALINA_HOME 指向了另一个旧版本，结果启动的是预期外的实例，日志和端口行为全都不对。
- 始终在**新开的终端**中验证：
echo %CATALINA_HOME%和%JAVA_HOME%\bin\java -version（Windows）或java -version（Linux/macOS，依赖 PATH） - 若只临时运行单个 Tomcat，可**不设全局
CATALINA_HOME**：直接进入其bin目录执行startup.bat，脚本会自动推导CATALINA_HOME为当前父目录 - 多实例部署时，务必删除全局
CATALINA_HOME，改用每个实例的setenv.bat/sh单独设置（如set CATALINA_HOME=D:\tomcat81）
Linux 下权限与 shell 配置文件加载顺序问题
在 Linux 中，/etc/profile、~/.bashrc、~/.bash_profile 加载时机不同。如果把 export CATALINA_HOME=... 写在 ~/.bashrc 里，但用 sudo ./startup.sh 启动，实际读取的是 root 用户的环境，而非当前用户的配置。
- 系统级配置优先写入
/etc/profile.d/tomcat.sh（需可执行权限），内容为：export CATALINA_HOME=/opt/tomcat - 避免用
sudo启动 Tomcat；应创建专用用户（如tomcat），并用sudo -u tomcat /opt/tomcat/bin/startup.sh - 确认 shell 类型：Ubuntu 默认用 dash 执行
sh，而catalina.sh开头是#!/bin/sh，所以不要在/etc/profile中写 bash 特有语法（如数组）
真正卡住人的往往不是“没配”，而是“配了但没生效”或“配得看似对实则错”。尤其注意 Windows 路径中的反斜杠、Linux 中 su/sudo 切换用户后的环境隔离、以及多实例共存时的变量污染——这些细节不验证就动手，改十次也白搭。
