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 下用了系统属性设置却没重启命令行。

实操建议：

• 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。

server.xml 里要不要改 protocol="HTTP/1.1"？

不用动。这个配置项控制的是连接器协议类型，不是 JDK 或 Tomcat 版本适配的关键。新手常误以为要改成 org.apache.coyote.http11.Http11NioProtocol 才能“启用 NIO”，其实 Tomcat 8.5+ 默认就是它；HTTP/1.1 是协议标识符，底层实现由 protocol 属性自动匹配，除非你要切 APR 或 HTTP/2，否则保持默认即可。

sc-java-to-ts-interface

将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。

下载

真正要注意的是端口和编码：

• 确保 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 编译）会失败。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南