UnsupportedClassVersionError 是因 Tomcat 所需 JDK 版本高于当前运行环境，如 Tomcat 10.1+ 需 JDK 11+ 而本地仅装 JDK 8；应核对官方版本要求，确认 JAVA_HOME 指向正确 JDK 并验证 version.sh 输出。
Tomcat 启动报 UnsupportedClassVersionError 怎么办
这是 JDK 和 Tomcat 版本不匹配最典型的症状，本质是 Tomcat 用的 JDK 编译版本高于当前运行环境支持的版本。比如 Tomcat 10.1+ 默认要求 JDK 11+，但你本地只装了 JDK 8，启动时就会在控制台看到类似 java.lang.UnsupportedClassVersionError: org/apache/catalina/startup/Bootstrap has been compiled by a more recent version of the Java Runtime 的错误。
解决思路很直接：确认 Tomcat 官方文档中标明的最低 JDK 要求，再检查你 JAVA_HOME 指向的 JDK 版本是否达标。常用组合如下：
- Tomcat 9.0.x → 最低 JDK 8（推荐 JDK 8–11）
- Tomcat 10.0.x / 10.1.x → 最低 JDK 11（不兼容 JDK 8）
- Tomcat 11.0.x → 最低 JDK 17（LTS）
验证方式：终端执行 echo $JAVA_HOME（Linux/macOS）或 echo %JAVA_HOME%（Windows），再运行 $JAVA_HOME/bin/java -version 确认实际版本。别只看 java -version —— 它可能调用的是系统 PATH 里的另一个 JDK。
如何让 Tomcat 正确读取你配置的 JAVA_HOME
Tomcat 启动脚本（startup.sh 或 startup.bat）本身不强制依赖 JAVA_HOME，但它会优先使用它；如果没设，就 fallback 到 PATH 中第一个 java。问题常出在：你改了 JAVA_HOME，但忘了重新打开终端，或者 Windows 下用了系统属性设置却没重启命令行。
立即学习“Java免费学习笔记（深入）”；
实操建议：
- Linux/macOS：在
~/.bashrc或~/.zshrc中写死export JAVA_HOME=/path/to/jdk-11.0.23，然后source生效 - Windows：用「系统属性 → 高级 → 环境变量」设置系统级
JAVA_HOME（路径不含双引号，结尾不加/bin） - 临时覆盖：启动前手动执行
set JAVA_HOME=C:\Program Files\Java\jdk-17.0.2（Windows）或export JAVA_HOME=/opt/jdk-17（Linux/macOS）
验证是否生效：进到 tomcat/bin 目录，运行 ./version.sh（Linux/macOS）或 version.bat（Windows），输出里会明确显示 “JVM Version” 和 “JVM Vendor”，这才是 Tomcat 实际用的 JDK。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
server.xml 里要不要改 protocol="HTTP/1.1"？
不用动。这个配置项控制的是连接器协议类型，不是 JDK 或 Tomcat 版本适配的关键。新手常误以为要改成 org.apache.coyote.http11.Http11NioProtocol 才能“启用 NIO”，其实 Tomcat 8.5+ 默认就是它；HTTP/1.1 是协议标识符，底层实现由 protocol 属性自动匹配，除非你要切 APR 或 HTTP/2，否则保持默认即可。
真正要注意的是端口和编码：
- 确保
port="8080"没被其他进程占用（常见于已运行的另一个 Tomcat 或 Skype） - 在
Connector标签下加URIEncoding="UTF-8"，否则 URL 中中文参数会乱码 - 不要在
server.xml里硬编码应用路径（docBase），应通过部署 WAR 包或配置context.xml管理
改完 server.xml 必须重启 Tomcat 才生效，热加载不触发配置重读。
为什么浏览器访问 http://localhost:8080 显示 404，但 Tomcat 控制台没报错
说明 Tomcat 进程起来了，JDK 也没问题，但根应用（ROOT）没部署成功。Tomcat 9+ 默认不自带 ROOT 应用，解压后 webapps/ROOT 是空的，所以首页返回 404 是正常行为，不是故障。
快速验证方式：
- 访问
http://localhost:8080/manager/html（需先在conf/tomcat-users.xml中添加 manager 角色用户） - 把一个 WAR 包（如
myapp.war）丢进webapps/目录，等自动解压后访问http://localhost:8080/myapp - 检查
logs/catalina.out是否有部署失败日志，比如FAIL - Application at context path [/myapp] could not be started
注意：webapps 目录下不能有同名文件夹和 WAR 包共存（例如既有 myapp/ 又有 myapp.war），否则 Tomcat 会拒绝部署并静默跳过。
最容易被忽略的是：JDK 的 bin 目录是否真在 PATH 里（影响 jps、jstack 等诊断命令），以及 Windows 用户常把 JAVA_HOME 设成 JRE 路径而非 JDK 路径——Tomcat 启动虽不严格依赖 javac，但某些开发场景（如 JSP 编译）会失败。
