### 解决 Maven 构建过程中处理 Lombok JAR 文件时遇到的 `ClassFormatException` 错误 #### 问题分析 在使用 Tomcat 和 Maven 进行项目构建的过程中，如果遇到了类似于以下错误： - **Error Message**: ``` 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. ``` 这通常是因为某些库（如 Lombok 或 ASM）中的 `module-info.class` 文件无法被当前使用的 JDK 版本或 Tomcat 容器正确解析。具体来说，该问题是由于以下原因之一引起的[^1][^2]: 1. 使用了不兼容的 Java 版本：`module-info.class` 是 Java 9 及以上版本引入的新特性，而较低版本的 JVM 不支持此文件。 2. Tomcat 的 BCEL 库未更新到最新版本，因此无法识别新的字节码标签。 --- #### 解决方案 ##### 方法一：升级 JDK 到更高版本 确保项目的编译和运行环境都基于 Java 9 或更高版本。这是因为 `module-info.class` 是 Java 9 中新增的功能，只有较新版本的 JDK 才能正确解析它。可以通过修改 `pom.xml` 来指定目标 JDK 版本： ```xml <properties> <maven.compiler.source>11</maven.compiler.source> <maven.compiler.target>11</maven.compiler.target> </properties> ``` 同时，在本地环境中安装并配置对应版本的 JDK，并验证其可用性。 ##### 方法二：降级 Lombok 版本 如果暂时无法切换至高版本 JDK，则可以尝试降低 Lombok 的依赖版本。例如，将 Lombok 升级到更稳定的版本或将版本号回退到不含 `module-info.class` 的旧版（如 1.18.2）。以下是调整后的依赖项示例： ```xml <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.18.2</version> </dependency> ``` 注意：这种方法可能会影响部分高级功能的支持情况[^5]。 ##### 方法三：禁用模块化信息扫描 通过设置参数来跳过对 `module-info.class` 的加载操作也是一种可行的办法。可以在启动脚本或者 IDE 配置中加入如下选项以忽略此类条目： ```bash -Dignore.endorsed.dirs= ``` 对于 Maven 插件而言，也可以直接编辑插件配置实现相同效果： ```xml <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-war-plugin</artifactId> <configuration> <failOnMissingWebXml>false</failOnMissingWebXml> <!-- 添加排除规则 --> <packagingExcludes>META-INF/module-info.class</packagingExcludes> </configuration> </plugin> ``` ##### 方法四：更新 Tomcat 版本及其组件 考虑到原始问题描述提到的是 Tomcat7 结合 Struts2-Core 2.5.16+JDK1.7 的组合，建议考虑迁移到更加现代化的服务端框架以及容器上。因为低版本 Tomcat 对现代类结构缺乏良好适配能力，容易引发各种潜在隐患[^3]。 --- #### 总结代码片段 最终完整的解决方案应综合上述方法之一实施。下面给出一个典型的 POM 修改实例供参考： ```xml <!-- 设置合适的Java版本 --> <properties> <java.version>11</java.version> </properties> <dependencies> <!-- 调整Lombok版本 --> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.18.20</version><!-- 更改为你需要的具体稳定版本 --> <scope>provided</scope> </dependency> <!-- 其他必要依赖... --> </dependencies> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.8.1</version> <configuration> <source>${java.version}</source> <target>${java.version}</target> </configuration> </plugin> <!-- 如果适用的话，还可以增加WAR打包插件的相关配置 --> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-war-plugin</artifactId> <version>3.3.1</version> <configuration> <packagingExcludes>META-INF/module-info.class</packagingExcludes> </configuration> </plugin> </plugins> </build> ``` --- ###