Windows环境下Tomcat 10.1启动失败，如何排查报错？

1. 手动通过CMD启动，保留窗口查看输出 #

• 打开CMD命令提示符，手动切换到Tomcat 10.1的bin目录，例如：

  cd D:\apache-tomcat-10.1.x\bin
  

• 直接执行startup.bat，此时窗口不会自动关闭，能直接看到控制台的报错信息。

2. 验证Java版本兼容性 #

Tomcat 10.1要求Java 11及以上版本（Tomcat 9支持Java 8+），确认版本符合要求：

• 在CMD中执行java -version，查看版本号是否为11或更高。
• 检查环境变量：
  • 确保JAVA_HOME指向符合版本的JDK目录（不是JRE），比如C:\Program Files\Java\jdk-17。
  • 确认PATH中优先使用该JDK的bin目录，避免系统中其他低版本Java干扰。

3. 修改startup.bat强制保留窗口 #

• 打开Tomcat 10.1的bin\startup.bat文件，在文件末尾添加一行：

  pause
  

• 保存后双击执行，窗口会停留在最后一步，方便查看报错内容。

4. 直接启动catalina.bat获取详细日志 #

• 跳过startup.bat，直接在CMD中执行bin目录下的命令：

  catalina.bat run
  

• 该命令会在当前窗口输出Tomcat启动的所有详细日志，包括启动失败的核心原因，比startup.bat输出更直观。

5. 检查配置文件兼容性 #

• 对比Tomcat 9和10.1的conf目录核心配置文件（如server.xml、web.xml）：
  • Tomcat 10.1对配置语法要求更严格，若从Tomcat 9直接复制配置文件，可能存在不兼容的标签或属性。
  • 重点检查端口配置、连接器参数、全局Naming资源等内容。

6. 确认目录权限 #

• 避免将Tomcat 10.1安装在C:\Program Files或C:\Windows这类系统目录下，这类目录默认权限严格，可能导致Tomcat无法生成日志或写入临时文件。
• 右键Tomcat安装目录，选择“属性”-“安全”，确保当前用户拥有完全控制权限。

7. 检查端口占用 #

Tomcat默认使用8080（HTTP）、8005（关闭端口）、8009（AJP）端口，端口被占用会导致启动失败：

• 执行命令查看端口占用情况：

  netstat -ano | findstr "8080"
  netstat -ano | findstr "8005"
  netstat -ano | findstr "8009"
  

• 若端口被占用，可关闭占用进程，或修改conf\server.xml中的端口号。

内容的提问来源于stack exchange，提问作者sourabh sadhu