JDK 11 环境正确,端口未被占用,但是运行 Tomcat 11 仍然闪退
JDK 11 环境正确,端口未被占用,但是运行 Tomcat 11 仍然闪退
背景
当你遇到Tomcat启动后立即闪退的问题时,通常是由于环境变量配置错误、端口被占用或JDK版本不兼容等原因导致的。但我输入java -version也能正常打印版本,端口也没有占用,只剩下一个版本兼容问题了,因为 Tomcat 11 对 JDK 版本有较高的要求,详细分析见下文。
好的,JDK 11 运行 Tomcat 11 闪退是一个常见问题,主要是因为 Tomcat 11 对 JDK 版本有较高的要求。我们来系统地分析和解决这个问题。
核心原因分析
Tomcat 11.x 是为了与 Jakarta EE 10 规范兼容而设计的。从 Tomcat 10.x 开始,包命名空间从 javax.* 迁移到了 jakarta.*,这需要更高版本的 JDK 来提供对 Jakarta EE 的支持。
- Tomcat 11.0.x:要求 JDK 17 或更高版本。这是最根本的原因。
- Tomcat 10.1.x:要求 JDK 11 或更高版本。
- Tomcat 10.0.x:要求 JDK 8 或更高版本。
所以,如果你试图用 JDK 11 去运行 Tomcat 11,它会因为版本不兼容而立即失败(闪退)。
解决方案
根据你的需求,有以下几种解决方案:
方案一:升级 JDK(推荐,面向未来)
这是最直接、最正确的解决方案。既然你选择了最新的 Tomcat 11,就应该使用与之匹配的 JDK。
- 下载并安装 JDK 17 或更高版本(如 JDK 21 LTS)。
- 官网下载:Oracle JDK 或 OpenJDK
- 推荐使用 OpenJDK 发行版,如 Eclipse Temurin
- 配置
JAVA_HOME环境变量,使其指向新的 JDK 17 安装目录。- Windows:在系统环境变量中设置
JAVA_HOME。 - Linux/macOS:在
~/.bashrc或~/.zshrc中导出JAVA_HOME。
- Windows:在系统环境变量中设置
- 更新
PATH变量,确保%JAVA_HOME%/bin(Windows)或$JAVA_HOME/bin(Linux/macOS)在路径中。 - 验证:重新打开命令行,输入
java -version,确认显示的是 JDK 17 或更高版本。
现在再启动 Tomcat 11,应该就可以正常运行了。
方案二:降级 Tomcat(如果项目依赖 JDK 11)博主这里是直接降级使用了9.0的版本,可以成功运行
如果你的项目因为某些原因必须使用 JDK 11,那么你需要降级到与 JDK 11 兼容的 Tomcat 版本。
- 下载 Tomcat 10.1.x。
- 官网下载:Apache Tomcat® - Which Version Do I Want?
- 直接下载链接:Apache Tomcat 10.1.x
- 解压并替换掉你现在的 Tomcat 11 目录。
- 将你的 Web 应用程序(如果有的话)部署到 Tomcat 10.1 上。
注意:Tomcat 10.x 使用的是 jakarta.* 命名空间。如果你的项目是从 Tomcat 9.x 及以下版本迁移过来的,并且使用了 Servlet、JSP 等 API,你需要使用 迁移工具 将代码中的 javax.* 导入转换为 jakarta.*。
如果遇到启动日志乱码的情况
如果启动日志是下面这样(乱码),这是因为我们的dos窗口和Tomcat编码类型不一致导致的。

这时,我们需要在Tomcat根目录下的conf文件夹里的logging.properties,右键用记事本打开,找到java.util.logging.ConsoleHandler.encoding = UTF-8 这一行,在前面加个#,把他注释掉就好了

保存后再次运行startup.bat文件,可见窗口显示已经正常了

总结
| 你的情况 | 推荐方案 |
|---|---|
| 想使用 Tomcat 11 的最新功能 | 方案一:升级到 JDK 17+ |
| 项目必须使用 JDK 11 | 方案二:降级到 Tomcat 10.1.x |
