需匹配JDK与Tomcat版本：Tomcat 9支持JDK 8–11，10.1+支持11–17，11需JDK 17+；检查JAVA_HOME和实际java版本一致；正确创建setenv.sh/.bat配置JVM参数；确认webapps/ROOT存在且端口未被占用；Spring Boot 3.x适配Tomcat 10+的Jakarta EE。
Tomcat 启动失败：java.lang.UnsupportedClassVersionError 怎么办
这是最常见的环境错配问题，本质是 JDK 版本高于 Tomcat 编译所支持的最低版本。比如用 JDK 17 运行 Tomcat 9（仅支持到 Java 11），就会报这个错。
- 查 Tomcat 官方文档确认其支持的
JDK范围：Tomcat 9 → JDK 8–11；Tomcat 10.1+ → JDK 11–17；Tomcat 11 → JDK 17+ - 运行
java -version和$JAVA_HOME/bin/java -version，确认终端实际使用的 JDK 是否与JAVA_HOME一致 - Windows 下检查系统环境变量是否被 IDE（如 IntelliJ）或脚本覆盖；macOS/Linux 注意
~/.zshrc或/etc/profile中的export JAVA_HOME=...是否指向正确路径
setenv.sh / setenv.bat 不生效？内存和编码配置要这样加
Tomcat 默认不带 setenv 文件，必须手动创建，且位置、权限、命名都严格限定。
- Linux/macOS：在
$CATALINA_HOME/bin/下新建setenv.sh，首行加#!/bin/sh，并执行chmod +x setenv.sh - Windows：在
%CATALINA_HOME%\bin\下新建setenv.bat，不能是 .txt 后缀 - 关键配置示例（避免中文乱码和 OOM）：
export JAVA_OPTS="-Xms512m -Xmx1024m -Dfile.encoding=UTF-8"
- 不要写成
JVM_OPTS或CATALINA_OPTS（后者只影响启动脚本自身，不传给 JVM）
访问 http://localhost:8080 显示 404，但 catalina.out 没报错
不是启动失败，而是 Tomcat 默认不部署任何应用——连首页 ROOT 都可能被删了或未解压。
