需检查java -version和javac -version是否正常输出一致版本号且≥Tomcat要求,确认JAVA_HOME指向JDK根目录、PATH包含%JAVA_HOME%\bin或$JAVA_HOME/bin,启动后查看日志末尾是否有“Server startup in [X] milliseconds”,并用http://localhost:8080/manager/status或/docs验证服务就绪。

检查 java -version 和 javac -version 是否正常
Tomcat 依赖 JDK 运行,不是 JRE。如果只装了 JRE 或环境变量指向错误的路径,startup.bat(Windows)或 startup.sh(Linux/macOS)会直接报错退出,甚至不输出任何提示。
必须确保:
-
JAVA_HOME指向 JDK 根目录(如C:\Program Files\Java\jdk-17.0.1),不是jre子目录 -
%JAVA_HOME%\bin(Windows)或$JAVA_HOME/bin(Linux/macOS)已加入PATH - 终端中执行
java -version和javac -version输出版本号一致,且主版本号 ≥ Tomcat 要求(如 Tomcat 10 要求 JDK 11+)
运行 startup.bat 或 startup.sh 后看控制台日志
不要只看窗口是否弹出或是否立刻关闭——关键在日志末尾几行。成功启动的标志是出现类似这样的输出:
INFO [main] org.apache.catalina.startup.Catalina.start Server startup in [2456] milliseconds
常见失败现象及对应原因:
立即学习“Java免费学习笔记(深入)”;
- 窗口闪退 →
java命令找不到,检查JAVA_HOME和PATH - 报错
Neither the JAVA_HOME nor the JRE_HOME environment variable is defined→setenv.bat/sh被误删,或未设环境变量 - 报错
Address already in use: bind→ 端口被占用(默认 8080),可改conf/server.xml中Connector port="8080" - 启动后访问
http://localhost:8080显示 404 → Tomcat 其实已运行,但默认不部署 ROOT 应用(较新版本移除了webapps/ROOT下的示例页)
验证 http://localhost:8080 是否返回有效响应
Tomcat 9.0.83+、10.1.15+、11.0.0-M19+ 默认不再自带欢迎页,访问 http://localhost:8080 返回 404 是正常行为,不代表失败。
真正有效的验证方式是:
- 访问
http://localhost:8080/manager/status(需先配置 manager 用户)→ 若返回登录页或 XML 状态页,说明服务已就绪 - 访问
http://localhost:8080/docs/→ 若能打开 Tomcat 官方文档页面,说明webapps/docs已正确部署 - 临时放一个
test.jsp到webapps/ROOT/(若不存在则新建),内容为,再访问http://localhost:8080/test.jsp
注意:webapps/ROOT 目录在解压即用版中可能为空,需手动创建;若用安装版(.exe),该目录通常存在但内容被精简。
确认 catalina.pid 和进程是否存在(Linux/macOS)
在类 Unix 系统中,startup.sh 会生成 work/catalina.pid 文件(取决于 CATALINA_PID 配置)。它记录的是 JVM 进程 ID,不是判断依据的唯一标准——因为 PID 文件可能残留,而进程已死。
更可靠的方式是:
- 执行
ps aux | grep tomcat,确认有org.apache.catalina.startup.Bootstrap进程 - 执行
lsof -i :8080(或netstat -tuln | grep :8080),确认端口处于LISTEN状态 - 若
catalina.out日志里没有 ERROR 或 SEVERE 行,且最后几行含Server startup in,基本可判定启动成功
别只盯着 PID 文件是否存在——它容易误导,尤其在反复启停后没清理干净时。










