Tomcat部署Spring Boot应用报错：缺失IReadStream.class类文件

核心报错信息 #

Caused by: org.apache.catalina.LifecycleException: 启动组件失败 [StandardEngine[Catalina].StandardHost[localhost].StandardContext[/socr-microservices]]
	at org.apache.catalina.util.LifecycleBase.handleSubClassException(LifecycleBase.java:440)
	at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:198)
	at org.apache.catalina.core.ContainerBase.addChildInternal(ContainerBase.java:726)
	... 43 more
Caused by: org.springframework.beans.factory.BeanDefinitionStoreException: 解析配置类[com.my.BackendApplication]失败；嵌套异常为java.io.FileNotFoundException：无法打开类路径资源[com/abbyy/FCEngine/IReadStream.class]，因为该文件不存在
	at org.springframework.context.annotation.ConfigurationClassParser.parse(ConfigurationClassParser.java:189)
	... 44 more
Caused by: java.io.FileNotFoundException：无法打开类路径资源[com/abbyy/FCEngine/IReadStream.class]，因为该文件不存在
	at org.springframework.core.io.ClassPathResource.getInputStream(ClassPathResource.java:199)
	... 15 more

问题根源 #

项目依赖了Abbyy的FCEngine组件，但对应的IReadStream.class未被正确打包到部署war包中，或是Tomcat类路径下找不到该类文件。

解决步骤 #

• 核对依赖配置：检查项目构建文件（Maven的pom.xml或Gradle的build.gradle），确认Abbyy相关依赖已正确引入，依赖scope设置无误；若为本地Jar包，需确保本地依赖路径配置正确。
• 验证依赖Jar包完整性：如果Abbyy依赖是本地Jar包，解压Jar包或执行jar tvf your-abbyy.jar命令，确认包内包含com/abbyy/FCEngine/IReadStream.class。
• 检查打包配置：
  • Maven：确认war插件未排除Abbyy依赖，spring-boot-maven-plugin打包配置未遗漏相关组件。
  • Gradle：检查war任务配置，确保所有必要依赖都被打包至war包的WEB-INF/lib目录。
• Tomcat类路径校验：若依赖放在Tomcat全局lib目录而非war包内，确认CATALINA_HOME/lib或CATALINA_BASE/lib下存在正确版本的Abbyy Jar包。
• 重新打包部署：执行清理、构建、打包操作（Maven：mvn clean package；Gradle：gradle clean war），替换Tomcat中的war包后重启服务验证。

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