1. 问题现象与背景解析
最近在IDEA中启动Spring Boot项目时,控制台突然抛出"missing ServletWebServerFactory"异常,这个错误让不少开发者感到困惑。作为使用Spring Boot框架的常见问题之一,它通常发生在项目配置或依赖存在问题时。
ServletWebServerFactory是Spring Boot自动配置的核心接口之一,负责创建嵌入式Web服务器(如Tomcat、Jetty等)。当Spring Boot无法找到合适的实现类时,就会抛出这个异常。这种情况多发生在:
- 错误地排除了spring-boot-starter-web依赖
- 依赖冲突导致自动配置失效
- 自定义配置覆盖了默认行为
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 根本原因深度分析
2.1 依赖缺失的典型场景
最常见的原因是项目中缺少必要的starter依赖。Spring Boot通过starter机制自动配置Web环境,当缺少spring-boot-starter-web时,自动配置将无法完成:
xml复制<!-- 缺失这个关键依赖会导致问题 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
2.2 依赖冲突与排除问题
另一种情况是项目中存在依赖冲突,或者人为排除了关键组件。例如:
xml复制<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<!-- 错误地排除了tomcat starter -->
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
