1. 问题现象与背景解析
最近在IDEA中启动Spring Boot项目时,控制台突然抛出"Missing ServletWebServerFactory bean"异常,导致应用无法正常启动。这个错误看似简单,实则涉及Spring Boot自动配置的核心机制。作为使用Spring Boot 2.7.3的开发老手,我花了半小时才定位到根本原因,这里把排查过程和解决方案完整记录下来。
ServletWebServerFactory是Spring Boot内嵌Web容器的工厂接口,Tomcat、Jetty等容器的自动配置类都会注册这个bean。当Spring容器找不到任何可用的Web服务器工厂时,就会抛出这个异常。常见于以下场景:
- 错误地排除了Web相关starter依赖
- 主配置类扫描路径问题
- 多模块项目结构配置不当
- 自定义WebServerFactory导致冲突
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心原因深度剖析
2.1 依赖树分析
首先检查pom.xml,确保存在spring-boot-starter-web依赖:
xml复制<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
但即使有这个依赖,仍可能因为以下原因失效:
- 父pom中声明了
<spring-boot.excludes>排除相关组件 - 项目中存在
@EnableAutoConfiguration(exclude={...})排除了WebMvcAutoConfiguration - 依赖冲突导致自动配置类未加载
建议用mvn dependency:tree检查是否存在以下问题:
- 传递性排除了tomcat-embed-core
- 引入了spring-boot-starter-webflux导致冲突
- 版本不兼容(如Spring Boot 2.x与Jakarta EE 9+混用)
2.2 自动配置机制
Spring Boot通过@Conditional系列注解控制自动配置。关键点在于:
- Web环境检测:通过Servlet/Reactiv
