你遇到的日志错误信息如下：
```
严重
: Unable to process Jar entry [module-info
.class] from Jar [
...] for annotations
org
.apache
.tomcat
.util
.bcel
.classfile
.ClassFormatException
: Invalid byte tag in constant pool
: 19
```
### 回答问题
这个错误的根本原因是：**Tomcat 7 使用的 BCEL（Byte Code Engineering Library）库无法解析 Java 9+ 引入的 `module-info
.class` 文件中的新
字节码格式，尤其是当类文件版本高于其支持范围时（如 Java 8+ 编译的 class 文件）。**
#### 错误原因详解：
1
. **Tomcat 版本过旧（Tomcat 7
.0
.47）**
- Tomcat 7 发布于 2010 年左右，最初只支持到 Java 7。
- 虽然后续版本支持 Java 8，但对 Java 8 的某些特性（特别是模块化相关的 `
.class` 文件结构）支持不完整。
- `Invalid byte tag in constant pool
: 19` 中的 “tag 19” 指的是 JVM 常量池中新增的一种类型 —— `CONSTANT_Module` 或 `CONSTANT_Package`，这是 Java 9 模块系统引入的新常量类型。而 Tomcat 7 内部使用的 BCEL 库不认识这种 tag，导致解析失败。
2
. **jar 包包含 `module-info
.class`**
- Jackson 2
.11.3 是为 Java 8+ 设计的库，并且包含了 `module-info
.class`（用于 Java 9+ 模块系统），该文件由 JDK 9+ 编译生成，带有新的 class 文件格式。
- 当 Tomcat 扫描这些 JAR 文件以查找 Servlet 注解（如 `@WebServlet`, `@WebFilter` 等）时，会尝试读取所有 `
.class` 文件，包括 `module-info
.class`，从而触发异常。
3
. **不影响运行？**
- 尽管报错级别是“严重”，但大多数情况下 **应用仍能正常启动和运行**（从你的日志看 Spring 已成功初始化 DispatcherServlet）。
- 这是因为这些错误仅发生在注解扫描阶段，而现代 Spring Boot 或基于 web
.xml / WebApplicationInitializer 的项目并不依赖 Tomcat 的自动注解扫描来注册核心组件。
---
### 解决方案
#### ✅ 推荐方案一：升级 Tomcat 版本（最佳实践）
升级到 **Tomcat 8
.5 或更高版本（如 Tomcat 9/10）**，它们完全支持 Java 8+ 和模块化 class 文件。
```xml
<!-- 如果你在使用 Maven + Tomcat 插件，请使用以下配置 -->
<plugin>
<groupId>org
.apache
.tomcat
.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2
.2</version>
<configuration>
<!-- 改用 Tomcat 8 或使用其他插件 -->
</configuration>
</plugin>
```
更好的选择是改用 **Spring Boot + 内嵌 Tomcat**，它默认使用较新版本的 Tomcat。
---
#### ✅ 推荐方案二：排除或屏蔽 `module-info
.class` 扫描
如果你必须使用 Tomcat 7，可以通过修改 `context
.xml` 来阻止 Tomcat 扫描特定 JAR 中的注解：
##### 方法：在 `META-INF/context
.xml` 中添加 `JarScanner` 配置
```xml
<Context>
<JarScanner>
<JarScanFilter
defaultTldScan="false"
tldScan="*
.jar"
pluggabilityScan="false"
annotationScan="false"/>
</JarScanner>
</Context>
```
或者更精细地跳过 Jackson 相关注解扫描：
```xml
<Context>
<JarScanner>
<JarScanFilter
defaultAnnotationFilter="true"
annotationFilter="jackson-
.*,spring-
.*,hibernate-
.*"/>
</JarScanner>
</Context>
```
这将告诉 Tomcat 不去扫描匹配正则表达式的 JAR 文件中的注解，避免加载 `module-info
.class`。
---
#### ✅ 方案三：手动移除 `module-info
.class`（不推荐生产环境）
你可以使用脚本或构建工具从 Jackson 的 JAR 文件中删除 `module-info
.class`：
```bash
zip -d jackson-core-2
.11.3
.jar module-info
.class
zip -d jackson-annotations-2
.11.3
.jar module-info
.class
zip -d jackson-databind-2
.11.3
.jar module-info
.class
```
⚠️ 注意：这会修改原始依赖包，可能导致违反许可证、部署一致性等问题，仅适用于测试或受限环境。
---
#### ✅ 方案四：禁用整个注解处理（极端情况）
在 `web
.xml` 中设置 `<metadata-complete="true">`，关闭 Tomcat 的注解扫描：
```xml
<web-app xmlns="http
://java
.sun
.com/xml/ns/javaee"
xmlns
:xsi="http
://www
.w3
.org/2001/XMLSchema-instance"
xsi
:schemaLocation="http
://java
.sun
.com/xml/ns/javaee
http
://java
.sun
.com/xml/ns/javaee/web-app_3_0
.xsd"
version="3
.0"
metadata-complete="true">
<!-- 其他配置 -->
</web-app>
```
这样 Tomcat 就不会尝试扫描任何 JAR 文件的注解，彻底规避问题。
---
### 总结
| 方案 | 是否推荐 | 说明 |
|------|----------|------|
| 升级 Tomcat 到 8
.5+ | ✅✅✅ 强烈推荐 | 根本解决兼容性问题 |
| 配置 `JarScanner` 过滤 | ✅ 推荐 | 快速修复老版本兼容问题 |
| 删除 `module-info
.class` | ⚠️ 谨慎使用 | 可行但破坏依赖完整性 |
| 设置 `metadata-complete="true"` | ✅ 可接受 | 若不用注解自动注册 |
---
### 相关建议
- Tomcat 7 已于
2021 年停止维护，存在安全风险，建议尽快迁移至 Tomcat 9 或以上。
- Jackson 2
.11.3 最低要求 Java 8，但编译目标可能是 Java 9+，与老旧容器不兼容属正常现象。
- 使用 Spring Boot 可自动管理内嵌容器版本，避免此类底层冲突。
---
本文介绍了字节码在Java中的重要性，它作为JVM的中间表示，允许跨语言交互。通过分析字节码，开发者可以洞察Volatile等关键字的底层实现。字节码也在Spring AOP、ORM框架和热部署中发挥关键作用。理解字节码能帮助开发者更好地学习和掌握基于JVM的语言，如Scala和Kotlin。
扫一扫
2127
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
