Spring Boot启动失败：ApplicationContextException相关报错求助

我之前也碰到过类似的Tomcat嵌入式容器初始化失败的问题，咱们一步步来梳理可能的原因和解决办法：

1. 依赖冲突是重灾区 #

Spring Boot的自动配置对Tomcat版本有严格的适配要求，如果项目里混入了其他Servlet容器（比如Jetty、Undertow）或者自定义了Tomcat相关依赖，很容易出现版本冲突。

• 排查方法：
  用Maven或Gradle查看依赖树，揪出冲突的依赖：
  • Maven：执行 mvn dependency:tree
  • Gradle：执行 ./gradlew dependencies
    重点找tomcat-embed-*相关的重复依赖，或者意外引入的其他Servlet容器依赖。
• 解决办法：
  排除冲突的依赖，比如不小心引入Jetty的话，就在spring-boot-starter-web里排除它：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
      <exclusions>
          <exclusion>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-starter-jetty</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

2. 端口被占用 #

Tomcat默认用8080端口，如果这个端口被其他进程占了，容器肯定启动不了。

• 排查方法：
  • Windows：打开命令提示符，执行 netstat -ano | findstr :8080，找到占用端口的进程ID（PID）
  • Linux/Mac：执行 lsof -i :8080 查看占用进程
• 解决办法：
  要么杀掉占用端口的进程，要么在配置文件里修改Spring Boot的端口：

  # application.properties
  server.port=8081
  

3. 自定义Tomcat配置出错 #

如果你的项目里自定义了Tomcat的配置（比如通过TomcatServletWebServerFactory或者EmbeddedServletContainerCustomizer），参数配置错误会直接导致Bean初始化失败。

• 排查方法：
  找到项目里的自定义配置类，检查有没有错误设置连接器、线程池参数，或者配置了不存在的SSL证书路径这类问题。
• 解决办法：
  先注释掉所有自定义的Tomcat配置，让项目先正常启动，再逐步恢复配置并测试，定位出具体出错的配置项。

4. 系统资源不足 #

Tomcat启动需要足够的内存和文件描述符，如果JVM内存分配不够，或者系统文件描述符限制太低，也会触发初始化失败。

• 排查方法：
  • 检查JVM启动参数，是否设置了合理的堆内存（比如-Xms512m -Xmx1024m）
  • Linux系统执行 ulimit -n 查看文件描述符限制，一般建议设置为65535
• 解决办法：
  调整JVM启动参数，或者修改系统的文件描述符限制（需要root权限）。

5. 类路径资源损坏或缺失 #

如果本地仓库里的Tomcat相关Jar包损坏，或者项目编译后类路径下缺少必要的类，也会导致Bean创建失败。

• 排查方法：
  清理本地仓库的缓存（Maven的.m2/repository，Gradle的~/.gradle/caches），然后重新下载依赖；同时清理项目的target或build目录，重新编译打包。

如果以上方法都没解决问题，建议你把完整的异常栈信息贴出来，这样能更精准地定位到具体的故障点。

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