当前位置：首页 > article >正文

填坑记: 古董项目Apache POI 依赖异常排除

article 2025/9/26 21:08:19

当你看到NoSuchMethodError的时候，不要慌，深呼吸，这可能只是JAR包版本的问题…

引子：一个平静的周二下午

那是一个看似平常的周二下午，系统运行良好，开发团队在有条不紊地推进着新功能的开发。突然，测试环境中的报表导出功能失效了，用户反馈页面卡住，后台日志疯狂刷屏：

java.lang.NoSuchMethodError: 'byte[] org.apache.poi.util.IOUtils.peekFirstNBytes(java.io.InputStream, int)'

作为职业填坑人，我看到这个错误的第一反应是：“这是依赖不对？”

错误分析：深入错误堆栈的兔子洞

先来仔细分析一下错误信息：

Caused by: java.lang.NoSuchMethodError: 'byte[] org.apache.poi.util.IOUtils.peekFirstNBytes(java.io.InputStream, int)'at org.apache.poi.poifs.filesystem.FileMagic.valueOf(FileMagic.java:209)at org.apache.poi.openxml4j.opc.internal.ZipHelper.verifyZipHeader(ZipHelper.java:143)at org.apache.poi.openxml4j.opc.internal.ZipHelper.openZipStream(ZipHelper.java:175)at org.apache.poi.openxml4j.opc.ZipPackage.<init>(ZipPackage.java:130)at org.apache.poi.openxml4j.opc.OPCPackage.open(OPCPackage.java:319)at ca.terrasoft.poi.POIUtil.openFile(POIUtil.java:57)

从堆栈可以看出：

系统试图调用IOUtils.peekFirstNBytes方法
该方法在运行时的类路径中不存在
错误发生在处理Excel文件时（看调用链包含openFile和ZipPackage）

这应该是一个典型的JAR包版本不一致问题。简单说，代码期望调用的方法在运行时环境中找不到，通常是因为编译时使用的库版本与运行时加载的版本不同。

侦探工作：寻找证据

由于项目是一个20年前的古董JSP项目，没有使用Maven、Gradle等现代构建工具，所有依赖都直接堆在WEB-INF/lib目录下。我们只能通过手动和脚本方式排查依赖。

直接检查WEB-INF/lib目录

$ ls -la /webapps/myapp/WEB-INF/lib/poi-*.jar
.....
-rw-r--r-- 1 tomcat tomcat 2758112 May 10 14:32 poi-5.2.3.jar

表面上看，POI的版本是5.2.3，应该没问题,会不会是某个古董jar中可能有依赖老版本poi，那咋整? 一个一个去翻所有jar包? 嗯嗯，这好像不是码农该做的事。

终极武器：编写诊断JSP页面

为了更详细地了解web容器中类加载情况，直接整一个简单的诊断页面：

<%@ page import="java.net.URL" %>
<%@ page import="java.util.Enumeration" %>
<%@ page import="java.io.File" %>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>Classpath Info</title></head>
<body>
<h1>Classpath Information</h1>
<h2>Finding POI libraries:</h2>
<ul><%// 查找指定类的位置try {Class<?> clazz = Class.forName("org.apache.poi.util.IOUtils");out.println("<li>IOUtils class found at: " + clazz.getProtectionDomain().getCodeSource().getLocation() + "</li>");// 查找方法是否存在try {clazz.getDeclaredMethod("peekFirstNBytes", java.io.InputStream.class, int.class);out.println("<li>peekFirstNBytes method exists!</li>");} catch (NoSuchMethodException e) {out.println("<li>peekFirstNBytes method NOT found!</li>");}} catch (Exception e) {out.println("<li>Error: " + e.getMessage() + "</li>");}%>
</ul><h2>All POI related JARs:</h2>
<ul><%ClassLoader cl = Thread.currentThread().getContextClassLoader();try {Enumeration<URL> resources = cl.getResources("META-INF/MANIFEST.MF");while (resources.hasMoreElements()) {URL url = resources.nextElement();String path = url.getPath();if (path.contains("poi")) {out.println("<li>" + path + "</li>");}}} catch (Exception e) {out.println("<li>Error: " + e.getMessage() + "</li>");}%>
</ul>
</body>
</html>

运行后，页面输出：

IOUtils class found at: file:/Users/xdev/workdir/myProject/classes/artifacts/myProject_war_exploded/WEB-INF/lib/tm-extractors.jar
* peekFirstNBytes method NOT found! .

这说明，虽然我们有poi-5.2.3.jar，但实际被加载的IOUtils类却来自tm-extractors.jar！

版本考古学：揭开历史的面纱

进一步到Maven仓库查询tm-extractors.jar（https://mvnrepository.com/artifact/org.textmining/tm-extractors/0.4），发现它自带了poi-2.5.1.jar，而且tm-extractors的发布时间非常久远。

也就是说，tm-extractors.jar中自带的老版本POI类覆盖了新版本POI的类加载，导致我们即使有poi-5.2.3.jar，实际运行时却用的是2.5.1的实现，自然没有peekFirstNBytes方法。

病因揭晓：依赖地狱

最终我们发现，问题出在tm-extractors.jar这个古老依赖。它内部包含了POI 2.5.1的class文件，且优先被类加载器加载，覆盖了我们显式依赖的poi-5.2.3。

具体来说：

项目直接依赖poi-5.2.3.jar
WEB-INF/lib目录下还存在tm-extractors.jar，它内部自带poi 2.5.1
由于类加载顺序，IOUtils等POI类被加载自tm-extractors.jar
代码中使用了5.x版本的API，但运行时加载了2.5.1版本的类

这就是经典的依赖地狱（Dependency Hell），而且在没有构建工具的老项目中更为棘手。

解决方案：手动清理与依赖排查

对于没有构建工具的老JSP项目，解决这类问题通常只能靠手动：

方案一：清理lib目录，移除冲突依赖

停止Tomcat服务器
备份当前的WAR文件或lib目录
检查WEB-INF/lib目录，移除tm-extractors.jar或用工具（如jar命令）剥离其中的POI相关class文件
确保只保留一个版本的POI（推荐新版本）
重新部署并测试

方案二：替换或升级依赖

如果必须使用tm-extractors功能，尝试寻找不自带POI的版本，或用更现代的替代库
或者自行编译一个去除POI依赖的tm-extractors.jar

方案三：类加载器隔离（高阶方案）

对于有能力自定义类加载器的容器，可以尝试隔离不同JAR包的类加载（但对老JSP项目不现实）

我们的选择

考虑到项目情况，我们最终选择了方案一：手动清理WEB-INF/lib目录，移除tm-extractors.jar，只保留poi-5.2.3.jar。这样虽然失去了一些老库的功能，但保证了POI相关功能的正常运行。

具体步骤：

手动排查并清理lib目录
检查所有JAR包是否有嵌套依赖（可用jar tf命令查看）
全面测试Excel导入导出功能
在测试环境部署并验证

预防措施：避免再次踩坑

痛定思痛，我们制定了一系列措施来防止类似问题再次发生：

定期清理lib目录：避免历史遗留JAR包混杂
建立依赖引入审核机制：新依赖必须经过技术负责人审核
自动化测试：为Excel导入导出功能添加全面的自动化测试
文档化依赖关系：手工维护一份依赖清单
推动构建工具改造：有条件时逐步引入Maven/Gradle等现代构建工具

结语：教训与收获

这次POI依赖踩坑的经历，让我们深刻认识到了Java生态系统中依赖管理的重要性。对于没有构建工具的老项目，依赖冲突更容易发生且更难排查。

关键在于：

时刻保持警惕，特别是看到NoSuchMethodError这类错误时
建立系统的依赖管理机制
深入理解类加载机制和JAR包结构
不断学习和更新知识，跟踪常用库的版本变化

最后，我想用一句话来结束这篇文章：

在Java世界中，了解你的依赖就像了解你的朋友一样重要，当它们和平相处时，你的应用才能健康成长。

希望我的经验能帮助到同样面临依赖问题的开发者们。记住，你不是一个人在战斗！

填坑记: 古董项目Apache POI 依赖异常排除

当你看到NoSuchMethodError的时候，不要慌，深呼吸，这可能只是JAR包版本的问题… 引子：一个平静的周二下午那是一个看似平常的周二下午，系统运行良好，开发团队在有条不紊地推进着新功能的开发。突然&#x…...

编程日记 2025/9/19 4:20:20

leetcode2934. 最大化数组末位元素的最少操作次数-medium

1 题目：最大化数组末位元素的最少操作次数官方标定难度：中给你两个下标从 0 开始的整数数组 nums1 和 nums2 ，这两个数组的长度都是 n 。你可以执行一系列操作（可能不执行）。在每次操作中，你可以选…...

编程日记 2025/9/24 19:50:24

环境配置与MySQL简介

目录 1 环境配置 2 MySQL简介 1 环境配置本专栏使用CentOS7进行讲解。首先我们查看系统中是否已经安装了MySQL，可以使用rpm -qa 命令查看系统安装包/压缩包列表这只是看我们是否下载过对应安装包，不一定就安装了。如果我们需要重新下载，…...

编程日记 2025/9/24 18:52:53

07_SpringBoot2集成Redis连接失败

🌟 07_SpringBoot2 集成 Redis 连接失败 ❓ 场景描述在 Spring Boot 2 项目中集成 Redis 时，将配置写成了如下形式： spring:data:redis:host: localhostport: 6379password: 123456结果启动项目时 Redis 连接失败，报错内容类似…...

编程日记 2025/6/13 9:57:39

mysql的一个缺点

最近再移植一个从oracle转mysql的项目，喜提一个报错： You cant specify target table A016 for update in FROM clause 对应的程序代码： public void setCurrent(String setId, String pk, String userId) throws SysException {String[]…...

编程日记 2025/8/7 6:20:03

适用于 iOS 的开源Ultralytics YOLO：应用程序和 Swift 软件包，用于在您自己的 iOS 应用程序中运行 YOLO

一、软件介绍文末提供程序和源码下载该项目利用 Ultralytics 最先进的 YOLO11 模型将您的 iOS 设备转变为用于对象检测的强大实时推理工具。直接从 App Store 下载该应用程序，或浏览我们的指南，将 YOLO 功能集成到您自己的 Swift 应用程序中。二、…...

编程日记 2025/9/24 19:17:13

Java零基础学习Day12——集合ArrayList

一、基本使用 1. 集合与数组集合只存引用数据类型；长度可变数组可存基本数据类型、引用数据类型；长度固定 2. 基本格式 ArrayList<String> list new ArrayList<>(); 3. 方法增、删 import java.util.ArrayList; public class St…...

编程日记 2025/9/24 18:53:42

[论文阅读]Formalizing and Benchmarking Prompt Injection Attacks and Defenses

Formalizing and Benchmarking Prompt Injection Attacks and Defenses Formalizing and Benchmarking Prompt Injection Attacks and Defenses | USENIX 33rd USENIX Security Symposium (USENIX Security 24) 提出了一个框架来形式化提示注入攻击，对提示注入攻击…...

编程日记 2025/9/24 18:56:06

ffmpeg 写入avpacket时候，即av_interleaved_write_frame方法是如何不需要业务层释放avpacket的逻辑分析

我们在通过 av_interleaved_write_frame方法写入 avpacket的时候，通常不需要关心 avpacket的生命周期。本文分析一下内部实现的部分。 ----> 代表一个内部实现。 A(){ B(); C(); } B(){ D(); } 表示为: A ---->B(); ---->D(); ---->C(); int…...

编程日记 2025/9/18 11:21:06

目标检测中的IoU损失函数

目标检测中的IoU损失函数目标检测中的IoU损失函数一、为什么需要IoU损失函数？二、常见IoU损失函数详解1. **IoU Loss**2. **GIoU Loss（Generalized IoU）**3. **DIoU Loss（Distance IoU）**4. **CIoU Loss（C…...

编程日记 2025/7/11 15:49:05

深入剖析 MyBatis 位运算查询：从原理到最佳实践

深入剖析 MyBatis 位运算查询：从原理到最佳实践引言在数据库设计中，位运算是一种高效存储和查询多选字段的常用技术。然而，在实际开发中，特别是在使用 MyBatis 这样的 ORM 框架时，位运算查询往往会遇到一些意想不到…...

编程日记 2025/7/24 6:06:59

JavaScript性能优化实战,从理论到落地的全面指南

在前端开发领域，JavaScript的性能优化是提升用户体验的核心环节。随着Web应用复杂度的提升，开发者面临的性能瓶颈也日益多样化。本文将从理论分析、代码实践和工具使用三个维度，系统性地讲解JavaScript性能优化的实战技巧，并通过大…...

编程日记 2025/9/24 18:59:23

第二个五年计划！

下一阶段！5年后！33岁！体重维持在125斤内！腰围74！ 健康目标： 体检指标正常，结节保持较小甚至变小！ 工作目标： 每年至少在一次考评里拿A（最高S，A我理…...

编程日记 2025/9/13 17:31:54

【行为型之中介者模式】游戏开发实战——Unity复杂系统协调与通信架构的核心秘诀

文章目录 🕊️ 中介者模式（Mediator Pattern）深度解析一、模式本质与核心价值二、经典UML结构三、Unity实战代码（成就系统协调）1. 定义中介者接口与同事基类2. 实现具体同事类3. 实现具体中介者4. 客户端使用四、模式…...

编程日记 2025/9/17 14:20:33

分布式微服务系统架构第125集：AI大模型

加群联系作者vx：xiaoda0423 仓库地址：https://webvueblog.github.io/JavaPlusDoc/ https://1024bat.cn/ 一、user 表（用户表） sql 复制编辑 create table if not exists user (id bigint auto_increment comment id pri…...

编程日记 2025/9/17 23:54:52

MySQL 8.0 OCP 英文题库解析（三）

Oracle 为庆祝 MySQL 30 周年，截止到 2025.07.31 之前。所有人均可以免费考取原价245美元的MySQL OCP 认证。从今天开始，将英文题库免费公布出来，并进行解析，帮助大家在一个月之内轻松通过OCP认证。本期公布试题16~25 试题16:…...

编程日记 2025/9/24 18:56:23

MapReduce 模型

‌引言‌ MapReduce 是分布式计算领域的里程碑式模型，由 Google 在 2004 年论文中首次提出，旨在简化海量数据处理的复杂性。其核心思想是通过函数式编程的 ‌Map‌ （映射）和 ‌Reduce‌ （归约）阶段&#x…...

编程日记 2025/7/24 3:51:15

Docker容器启动失败？无法启动?

Docker容器无法启动的疑难杂症解析与解决方案一、问题现象 Docker容器无法启动是开发者在容器化部署中最常见的故障之一。尽管Docker提供了丰富的调试工具，但问题的根源往往隐藏在复杂的配置、环境依赖或资源限制中。本文将从环境变量配置错误这一细节问题入手&am…...

编程日记 2025/9/24 18:38:03

mysql dump 导入导出用法

导出指定库中指定的表 mysqldump -uroot -pmysql databasename table1 table2 > ./bak.sql 导入 mysql -uroot -p123456 databasename< ./bak.sql 导出指定数据库 mysqldump -uroot -p123456 databasename > ./databasename.sql 导入： mysql -uroot…...

编程日记 2025/9/25 15:24:03

MySQL 数据类型全面指南：从理论到实践

在数据库设计和开发中，数据类型的选择是构建高效、可靠系统的基石。MySQL作为最流行的关系型数据库之一，提供了丰富的数据类型以满足各种数据存储需求。本文将全面介绍MySQL的数据类型体系，通过理论讲解和实际示例，帮助开发者做出…...

编程日记 2025/9/24 18:40:21

第二课：ESP32 使用 PWM 渐变控制——实现模拟呼吸灯或音调变化

第二课：ESP32 使用 PWM 渐变控制——实现模拟呼吸灯或音调变化 🧠 一、PWM 占空比与亮度/音量控制原理 PWM（Pulse Width Modulation，脉宽调制）是一种常用的数字信号控制方式，广泛应用于 LED 灯光亮度、电…...

编程日记 2025/6/10 13:06:48

Quartus与Modelsim-Altera使用手册

目录文章内容： 视频内容： Quartus： ModelSim： 顶层设计与子模块： 只是对所查阅的相关文章的总结与视频总结文章内容： 这篇对基础操作很详细： 一、Quartus II软件的使用_quartus2软件上…...

编程日记 2025/6/17 2:47:23

uniapp(微信小程序)＞关于父子组件的样式传递问题(自定义组件样式穿透)

在父组件中给子组件添加类名,子组件的样式由父组件决定由于"微信小程序"存在【样式隔离机制】，且默认设置为isolated(启用样式隔离)，因此这里给出以下两种解决方案： // 小程序编译机制 1. 当 <style scoped> 存在时&#…...

编程日记 2025/9/24 18:41:36

【HCIA】BFD

前言前面我们介绍了浮动路由以及出口路由器的默认路由配置，可如此配置会存在隐患，就是出口路由器直连的网络设备并不是运营商的路由器，而是交换机。此时我们就需要感知路由器的存活状态，这就需要用到 BFD（Bidirectio…...

编程日记 2025/9/24 18:38:32

计算机视觉最不卷的方向：三维重建学习路线梳理

提到计算机视觉（CV），大多数人脑海中会立马浮现出一个字：“卷”。卷到什么程度呢？2022年秋招CV工程师岗位数下降了16%，但求职人数增加了23%，求职人数与招聘岗位的比例达到了恐怖的15:1&#xff0…...

编程日记 2025/9/24 18:51:33

android抓包踩坑记录

由于需要公司业务需求，需要抓取APP中摄像机插件的网络包，踩了两天坑，这里做个总结吧。事先准备 android-studio emulatesdk 需要android模拟器和adb调试工具。如果已经有其他模拟器的话，可以只安装adb调试工具即可 mitmproxy…...

编程日记 2025/9/25 23:08:53

Webpack其他插件

安装html打包插件 const path require(path); const HtmlWebpackPlugin require(html-webpack-plugin) module.exports {entry: path.resolve(__dirname,src/login/index.js),output: {path: path.resolve(__dirname, dist),filename: ./login/index.js,clean:true},Plugin:…...

编程日记 2025/9/24 18:38:28