从Spring.io导入Demo项目启动时Tomcat异常求助

兄弟，你碰到的这个UnsatisfiedDependencyException是Spring Boot上下文初始化时的依赖注入问题，虽说只引入了Web依赖，但踩过的坑不少，我给你梳理几个靠谱的解决方向：

常见原因&解决步骤 #

• 1. 先查依赖版本冲突
  Spring Boot的starter-web会自动带Tomcat的全套依赖，要是你自己在pom.xml（或build.gradle）里手动加了其他版本的Tomcat相关包，比如tomcat-servlet-api或者tomcat-embed-core，十有八九会版本打架。

  • 解决：打开你的依赖管理文件，删掉所有手动加的Tomcat依赖，全靠spring-boot-starter-web自带的就行。用Maven的话，还可以执行mvn dependency:tree看看依赖树，确认有没有偷偷混进来的其他版本Tomcat包。

• 2. 检查配置文件有没有写错
  要是你在application.properties/yml里瞎改了Tomcat的配置，比如端口号设成了非数字、字符编码写了个不存在的，也会导致初始化崩掉。

  • 解决：先把所有Tomcat相关的自定义配置注释掉，启动试试。如果能正常起来，再逐个恢复配置项排查哪个出问题了。

• 3. 看看启动类的包位置对不对
  Spring Boot默认只会扫描启动类所在包及其子包的组件，要是你的启动类藏在深巷子的子包里，Spring找不到必要的Web组件，也会间接引发依赖注入失败。

  • 解决：把带@SpringBootApplication的启动类移到项目最顶层的包下，比如你的项目叫com.example.demo，启动类就放这个包下。要是确实需要扫描其他包，就在@SpringBootApplication上加scanBasePackages = {"com.xxx", "com.yyy"}指定范围。

• 4. 清理缓存&重新构建
  有时候项目构建后的缓存文件坏了，导致依赖加载异常，这种情况看着离谱但挺常见的。

  • 解决：
    • 用Maven的话执行mvn clean install，Gradle就跑gradle clean build，彻底清理后重新构建；
    • 把IDE的缓存目录删掉（比如IntelliJ的.idea文件夹，Eclipse的.metadata），重启IDE再重新导入项目。

• 5. 确认JDK版本兼容
  不同版本的Spring Boot对JDK有要求，比如你用Spring Boot 2.x却搭了JDK 1.7，肯定会出问题。

  • 解决：查一下你用的Spring Boot版本对应的JDK要求——比如2.0+要JDK8及以上，3.0+得JDK17及以上，换个兼容的JDK版本再试试。

进阶排查技巧 #

要是上面的方法都没用，你得把完整的错误日志贴出来（你现在的日志截断了），重点看Caused by那部分，那里会明确告诉你是哪个Bean的依赖注入失败，比如是不是某个自动配置类缺了必要的东西，这样就能精准定位了。

比如我之前碰到过一次，明明只加了Web依赖，但Maven依赖树里偷偷带了spring-boot-starter-security，没配置就导致依赖异常，你也可以用mvn dependency:tree排查下有没有这种意外引入的依赖。

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