Spring项目Tomcat部署失败：Context初始化失败问题求助

这种本地Eclipse跑正常、打包WAR就炸的情况我碰过太多次了，核心问题基本逃不开环境差异或者打包时的依赖/资源坑，咱们一步步来捋：

1. 先抓真正的异常根源 #

你现在看到的Destroying singletons只是Spring在初始化失败后的清理动作，不是问题本身！一定要去Tomcat的logs目录里找catalina.out或者localhost.log，翻到ERROR o.s.web.context.ContextLoader - Context initialization failed下面的**Caused by:堆栈信息**，那才是导致部署失败的真凶——比如数据库连不上、依赖缺失、配置文件解析错了之类的。

2. 排查依赖问题 #

• 依赖范围不匹配：如果用Maven/Gradle，检查pom.xml里的依赖范围，比如servlet-api、tomcat-embed-core这类如果标了provided，要确保部署的Tomcat里有对应版本的依赖，而且本地Eclipse的Tomcat和部署的Tomcat版本要一致，不然容易出现本地有依赖、部署环境缺包的情况。
• 依赖冲突：用mvn dependency:tree（Maven）或者gradle dependencies（Gradle）生成依赖树，看看有没有重复的、版本不一致的Spring核心包或者其他第三方jar——本地Eclipse可能靠依赖顺序规避了冲突，但打包后就会触发Bean初始化失败。
• 打包漏了依赖：解压WAR包，看看WEB-INF/lib里的jar是不是和本地Eclipse项目的Build Path里的依赖完全一致，有没有漏掉某个关键jar（比如spring-context-support这类容易被忽略的）。

3. 检查资源与配置路径 #

本地运行时，你可能用了相对路径读取配置文件（比如new File("src/main/resources/config.properties")），但WAR包解压后，项目根目录变成了Tomcat的webapps/你的应用名，这种路径肯定找不到文件！

正确的做法是用Spring的类路径读取方式：

// 用@Value注入类路径资源
@Value("classpath:config.properties")
private Resource configResource;

// 或者用ResourceLoader
@Autowired
private ResourceLoader resourceLoader;
Resource resource = resourceLoader.getResource("classpath:config.properties");

同时要确保src/main/resources下的配置文件都被正确打包到WEB-INF/classes目录里了。

4. 环境差异问题 #

• Tomcat版本不兼容：比如本地用Tomcat 9，部署用Tomcat 8，而你的Spring版本需要更高的Servlet规范（比如Spring 6需要Servlet 5.0，对应Tomcat 10+），版本不匹配直接导致上下文初始化失败。查一下你的Spring版本和Tomcat版本的兼容性表，确保两者匹配。
• JDK版本不一致：本地用JDK 11，部署环境用JDK 8，而你的代码里用了JDK 11的特性，或者Spring版本不支持JDK 8，这也会炸。
• 外部服务访问权限：本地能连的数据库、Redis等，部署的Tomcat服务器可能没有网络权限，或者配置里的地址还是localhost（本地测试用的），改成生产环境的真实地址就行。

5. 最后一步：模拟部署环境测试 #

如果还是找不到问题，可以在本地用Tomcat的startup.bat启动，把WAR包放到本地Tomcat的webapps目录里，看看能不能复现问题——这样就能排除服务器环境的差异，专注排查打包本身的问题。

按照这个思路排查，基本能快速定位到问题！我之前遇到过好几次都是依赖冲突或者配置路径写错导致的，先抓根异常是关键。

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