Spring应用启动创建Excel文件时遇ClassNotFoundException求助

你遇到的核心问题是编译时类路径和Web应用运行时类路径不匹配导致的。虽然你把Apache POI相关Jar包加到了Eclipse的构建路径里，能保证代码编译通过，但Web应用运行在Tomcat这类容器中时，它的类加载器只会从WEB-INF/lib目录下加载依赖Jar包——Eclipse的构建路径配置并不会自动把这些Jar包同步到Web应用的运行时目录中，这就导致Spring容器初始化时找不到需要的POI类。

具体解决步骤 #

• 第一步：找到你的Web项目的WEB-INF/lib目录，若不存在则手动创建该目录
• 第二步：将所有Apache POI相关的Jar包（包括poi.jar、poi-ooxml.jar，以及它们的依赖Jar包如commons-codec.jar、commons-collections4.jar等）复制到WEB-INF/lib目录下
• 第三步：重新将这些Jar包添加到Eclipse构建路径中（右键项目 → Build Path → Add External Archives，选择WEB-INF/lib下的Jar包，确保编译和运行时使用同一套依赖）
• 第四步：清理Web项目，重新部署到Tomcat，重启容器后再测试

额外检查点 #

• 确保所有POI相关Jar包版本统一，不要混合不同版本的依赖，否则可能引发其他类加载异常
• 检查Eclipse的Deployment Assembly配置：右键项目 → Properties → Deployment Assembly，确认WEB-INF/lib目录已被包含在部署列表中，这样Eclipse部署项目时会自动将Jar包打包到运行环境

补充说明：独立Java应用的类路径由构建路径或命令行参数指定，但Web应用遵循Servlet规范，容器优先从WEB-INF/lib和WEB-INF/classes加载类——这就是为什么你独立运行正常，迁移到Spring Web应用就报错的根本原因。

内容的提问来源于stack exchange，提问作者abyin007