需检查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 是正常行为,不代表失败。