解决 Tomcat 启动时 JAR 包 `Invalid byte tag in constant pool` 异常问题

个人名片

🎓作者简介：java领域优质创作者
🌐个人主页：码农阿豪
📞工作室：新空间代码工作室（提供各种软件服务）
💌个人邮箱：[2435024119@qq.com]
📱个人微信：15279484656
🌐个人导航网站：www.forff.top
💡座右铭：总有人要赢。为什么不能是我呢？

• 专栏导航：

码农阿豪系列专栏导航
面试专栏：收集了java相关高频面试题，面试实战总结🍻🎉🖥️
Spring5系列专栏：整理了Spring5重要知识点与实战演练，有案例可直接使用🚀🔧💻
Redis专栏：Redis从零到一学习分享，经验总结，案例实战💐📝💡
全栈系列专栏：海纳百川有容乃大，可能你想要的东西里面都有🤸🌱🚀

解决 Tomcat 启动时 JAR 包 Invalid byte tag in constant pool 异常问题

前言

在开发 Java Web 应用时，我们经常会使用 Apache Tomcat 作为 Servlet 容器进行部署和测试。然而，在项目启动过程中，有时会遇到类似于“Invalid byte tag in constant pool”的异常，这种异常通常与 Tomcat 对某些 JAR 包的解析不兼容有关，尤其是当你的项目中引入了不同版本的 JDK 和 JAR 包时。

本文将详细分析这一问题的成因，并探讨几种有效的解决方案。通过本文的学习，读者能够更好地理解 Java 项目中的依赖管理，掌握处理 JAR 包冲突以及 Tomcat 兼容性问题的技能。

问题描述

在启动 Tomcat 时，你可能会遇到如下报错信息：

Unable to process Jar entry [META-INF/versions/9/module-info.class] from Jar [jar:file:/path/to/your/jar/file] for annotations
org.apache.tomcat.util.bcel.classfile.ClassFormatException: Invalid byte tag in constant pool: 19at org.apache.tomcat.util.bcel.classfile.Constant.readConstant(Constant.java:127)...at org.apache.catalina.core.StandardContext.startInternal(StandardContext.java:5058)...

从日志来看，错误源自 Invalid byte tag in constant pool: 19，并且它与 module-info.class 文件相关。问题集中在 Tomcat 在处理 cos_api-bundle-5.6.35.jar 时遇到了无法解析的内容。

问题成因分析

这个异常信息提示我们，Tomcat 在处理 JAR 包中的注解时遇到了不兼容的字节码格式。具体来说，这通常是由于 JAR 包中的 module-info.class 文件所引起。module-info.class 是 Java 9 引入的模块系统的一部分，用于定义模块化的项目结构。如果你的项目使用的是 Java 8 或更早的版本，那么 Tomcat 会因为无法识别这个类文件而抛出异常。

以下是导致此问题的几个主要原因：

1. JAR 包版本不兼容：引入了基于 Java 9 或更高版本编译的 JAR 包，但项目或 Tomcat 使用的 JDK 是 Java 8 或更低版本。在这种情况下，Tomcat 无法处理 Java 9 的字节码格式。

2. Tomcat 版本过旧：一些较早的 Tomcat 版本（如 Tomcat 8.x 或更早）无法完全支持 Java 9 或更新的字节码规范，尤其是在处理 module-info.class 时。

3. 依赖冲突：项目中可能引入了多个不同版本的 JAR 包，它们可能编译自不同的 Java 版本，这也会导致兼容性问题。

解决方案

针对上述问题，我们可以从以下几个方面着手解决。

1. 升级 Tomcat 或 JDK 版本

最直接的解决方案是确保你的开发环境与依赖的 JAR 包相匹配。如果你正在使用 Java 9 或更高版本的 JAR 包，那么你应该：

• 升级你的 Tomcat 至支持 Java 9 或更高版本的最新版本。通常，Tomcat 9.x 及更高版本对 Java 9+ 具有较好的支持。
• 检查你的项目是否使用了低版本的 JDK。如果是，建议升级 JDK 至至少 Java 11 以确保兼容性。

在升级之后，重新启动 Tomcat，观察问题是否依然存在。如果问题解决，说明是因为 Java 版本和 Tomcat 版本之间的兼容性导致的。

2. 排除不需要的 JAR 包或版本

如果你不需要 JAR 包中的 module-info.class 文件，或者这些类文件对你的项目没有实际用途，你可以选择在构建配置文件中排除它们。例如，使用 Maven 或 Gradle 管理依赖时，你可以排除不兼容的模块。

在 Maven 中排除：

<dependency><groupId>com.qcloud</groupId><artifactId>cos_api-bundle</artifactId><version>5.6.35</version><exclusions><exclusion><groupId>module</groupId><artifactId>module-info</artifactId></exclusion></exclusions>
</dependency>

通过排除不需要的模块，你可以避免 Tomcat 在启动时对这些文件进行处理，从而减少出现异常的可能性。

3. 修改 Tomcat 的类加载器配置

有时候，我们可以通过调整 Tomcat 的类加载器设置，让它忽略某些特定的 JAR 包或类文件。这可以通过修改 Tomcat 的 context.xml 或 server.xml 文件来实现。

在 context.xml 文件中，可以通过设置 Context 标签的 jarsToSkip 属性来忽略特定的 JAR 包：

<Context><Parameter name="org.apache.catalina.startup.ContextConfig.jarsToSkip" value="*.jar" />
</Context>

这样配置后，Tomcat 将不会扫描所有的 JAR 包进行注解处理，从而避免了类似 module-info.class 的文件导致的异常。

4. 禁用 Tomcat 的注解扫描

如果你的项目中并不依赖注解处理功能，你还可以选择禁用 Tomcat 的注解扫描功能。这可以通过在 web.xml 文件中添加如下配置来实现：

<context-param><param-name>org.apache.catalina.startup.ContextConfig.jarsToSkip</param-name><param-value>*.jar</param-value>
</context-param>

这项配置告诉 Tomcat 跳过所有的 JAR 包中的注解扫描，避免由于解析不兼容的字节码而导致的启动失败。这种方式尤其适合那些不需要注解功能的老项目。

5. 确认依赖管理的正确性

最后一个常见的导致此类问题的原因是依赖管理不当，导致不同版本的依赖冲突。因此，检查依赖树，确保没有不同版本的同一 JAR 包引入是非常重要的。

使用 Maven 检查依赖冲突

可以使用以下命令检查 Maven 项目的依赖树：

mvn dependency:tree

通过分析依赖树，确认没有重复或冲突的依赖项，尤其是那些编译自不同版本的 Java 的 JAR 包。如果发现冲突，可以通过排除多余的依赖或锁定版本来解决。

总结

Tomcat 启动时遇到的 Invalid byte tag in constant pool: 19 错误，通常是由于不兼容的 Java 版本和模块系统引起的。为了解决这个问题，我们可以通过升级 Tomcat 或 JDK、排除不必要的 JAR 包、修改类加载器设置或者禁用注解扫描来避免启动失败。

项目中的依赖管理在 Java 开发中至关重要，尤其是在使用多个第三方库和框架时，确保它们的版本兼容性能够避免许多棘手的问题。通过本文的介绍，希望读者能够更好地理解 Tomcat 与 Java 版本兼容性的问题，并在实践中能够快速定位和解决类似的问题。