需检查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 是正常行为，不代表失败。
Java 接口排错助手
下载
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
真正有效的验证方式是：
- 访问
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 文件是否存在——它容易误导，尤其在反复启停后没清理干净时。
