环境变量未生效导致Tomcat命令报错，需检查配置文件加载时机（如/etc/profile或~/.bash_profile）、JAVA_HOME与CATALINA_HOME路径真实性及权限、执行source或重新登录使变量生效，并验证catalina.sh调用链中无硬编码覆盖。
Linux下配置完Tomcat环境变量后执行catalina.sh version报“command not found”，或启动脚本提示“Neither the JAVA_HOME nor the JRE_HOME environment variable is defined”，说明环境变量未被当前shell会话识别，需排查加载时机、作用域和路径有效性。
确认环境变量是否已写入正确配置文件
Linux中不同配置文件生效范围不同：/etc/profile对所有用户全局生效，~/.bashrc仅对当前用户当前shell类型（如bash）生效，~/.bash_profile在登录shell中优先读取。若你编辑的是~/.bashrc却用su切换用户或通过SSH非登录方式连接，该文件不会自动加载。
运行echo $SHELL确认当前shell类型；再执行sh -c 'echo $0'判断是否为登录shell。不是登录shell时，~/.bash_profile不会触发，而~/.bashrc也仅在交互式非登录shell中由bash主动source——但很多发行版默认不自动source它。
最稳妥做法是统一写入/etc/profile（所有用户）或~/.bash_profile（当前用户），二者任选其一并确保末尾有source ~/.bashrc（如果依赖其中的别名或函数）。
检查JAVA_HOME与CATALINA_HOME路径是否真实存在且权限可读
第一步：运行ls -ld $JAVA_HOME $CATALINA_HOME。若返回“No such file or directory”，说明路径写错或目录尚未创建。
第二步：确认JDK安装路径是否准确。不要直接复制网上示例中的/usr/lib/jvm/java-17-openjdk-amd64——你的系统可能是java-17-openjdk-x86_64或java-17-openjdk-jre。执行sudo update-java-alternatives -l或dirname $(dirname $(readlink -f $(which java)))获取真实路径。
第三步：检查Tomcat解压目录是否完整。进入$CATALINA_HOME后运行ls bin/catalina.sh conf/server.xml，缺任一文件说明解压不全或路径指向了空目录。
【关键前提】必须确保$JAVA_HOME/bin/java可执行，且$CATALINA_HOME/bin/catalina.sh具有x权限：chmod +x $CATALINA_HOME/bin/*.sh。
使环境变量立即生效的三种方法（按推荐顺序）
方法一：重新登录终端或新建SSH会话
这是最彻底的方式，能确保所有shell初始化文件按标准流程加载，避免source遗漏导致的变量嵌套失效问题。
在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...
方法二：手动source配置文件
若修改的是/etc/profile，运行source /etc/profile；
若修改的是~/.bash_profile，运行source ~/.bash_profile；
若修改的是~/.bashrc，先确认当前shell是否读取它——执行grep -q "source.*bashrc" ~/.bash_profile，无输出则需先在~/.bash_profile末尾添加source ~/.bashrc，再执行source ~/.bash_profile。
方法三：临时导出（仅当前终端有效）export JAVA_HOME=/your/real/jdk/path && export CATALINA_HOME=/your/tomcat/path && export PATH=$JAVA_HOME/bin:$CATALINA_HOME/bin:$PATH
这一步适合快速验证路径是否正确，但关闭终端即失效，不可用于服务部署。
验证环境变量是否真正生效
① 运行env | grep -E '^(JAVA_HOME|CATALINA_HOME|PATH)$'，确认三者均显示为预期路径，且无空格、中文或波浪线（~）残留。
② 执行$CATALINA_HOME/bin/catalina.sh version，应输出类似Server version: Apache Tomcat/10.1.30的内容。若仍报错，检查catalina.sh开头是否硬编码了JAVA_HOME——部分旧版脚本会跳过环境变量直接读./setclasspath.sh，此时需同步修改该文件中的JAVA_HOME赋值行。
③ 运行which catalina.sh，应返回/path/to/tomcat/bin/catalina.sh而非not found。若返回空，说明PATH未包含$CATALINA_HOME/bin，或冒号前后存在多余空格导致路径断裂。
【易错点】在export PATH=...中误写成export PATH = ...（等号两侧加空格），bash会将其解析为执行命令export并传入参数PATH和=...，导致语法错误且变量未设置。
修复setclasspath.sh中JAVA_HOME硬编码问题
当catalina.sh调用setclasspath.sh时，后者可能覆盖你在/etc/profile中设置的JAVA_HOME。打开$CATALINA_HOME/bin/setclasspath.sh，查找形如JAVA_HOME="/opt/java"的行。
将该行注释掉（前面加#），并在其上方插入：if [ -z "$JAVA_HOME" ]; then echo "Error: JAVA_HOME is not set. Please configure it in /etc/profile or ~/.bash_profile." exit 1fi
这能强制脚本使用外部定义的JAVA_HOME，避免内部路径与系统实际JDK位置冲突。修改后无需重启，下次执行startup.sh即生效。
