配置Bamboo CICD服务器遇启动错误：CATALINA_HOME环境变量配置异常
2026-5-27
解决Bamboo启动时CATALINA_HOME未正确定义的问题
我之前帮团队排查过几乎一模一样的Bamboo启动故障，给你几个针对性的排查和修复步骤，应该能解决问题：
先确认环境变量的实际生效状态：别只看系统设置面板的配置，直接在启动Bamboo的命令行里执行对应命令验证：
- Windows（cmd）：
echo %CATALINA_HOME%和echo %JAVA_HOME% - Linux/macOS（终端）：
echo $CATALINA_HOME和echo $JAVA_HOME
重点检查：输出的路径是不是绝对路径，有没有空格或特殊字符，且必须指向Bamboo自带的Tomcat目录（通常是<你的Bamboo安装目录>/atlassian-bamboo/tomcat，不是单独安装的Tomcat路径）。
- Windows（cmd）：
检查环境变量的配置范围：如果是在用户变量里配置的，但用管理员身份启动Bamboo，大概率读不到用户变量；反之同理。建议把CATALINA_HOME、JAVA_HOME同时配置到系统级环境变量（Windows）或全局配置文件（Linux/macOS的
/etc/profile或/etc/bashrc），配置后重启命令行甚至机器再尝试启动。排查启动脚本的硬编码覆盖：Bamboo的启动脚本（
start-bamboo.bat或start-bamboo.sh）里可能会重新定义CATALINA_HOME。打开脚本搜索类似以下的代码：- Windows：
set CATALINA_HOME=xxx - Linux/macOS：
export CATALINA_HOME=xxx
如果发现有这类行，要么把路径改成你实际的Tomcat目录，要么直接注释掉这一行，让脚本读取系统环境变量。
- Windows：
验证目录权限（Linux/macOS专属）：如果是类Unix系统，权限不足会导致启动脚本无法读取目录内容，进而误判CATALINA_HOME无效。执行以下命令修复权限：
chmod -R 755 <你的Bamboo安装目录>确认Java版本兼容性：Bamboo对Java版本有严格要求（比如新版本需要Java 11/17），如果Java版本不符合要求，即使JAVA_HOME配置正确，也可能间接引发CATALINA_HOME的检测错误。执行
java -version确认版本是否匹配你安装的Bamboo版本要求。
内容的提问来源于stack exchange，提问作者Ash
相关产品推荐
相关产品推荐
