为什么排除javax.servlet后会出现missing ServletWebServerFactory bean的问题？

Question

在Spring Boot项目中，如果排除`javax.servlet`依赖，运行时会出现“missing ServletWebServerFactory bean”的错误。这是因为`javax.servlet`是Servlet规范的核心API，而`ServletWebServerFactory`是Spring Boot用于创建嵌入式Web服务器（如Tomcat、Jetty）的关键组件。它依赖于Servlet API来配置和初始化Web服务器。 当排除`javax.servlet`后，Spring Boot无法找到必要的Servlet类来配置嵌入式服务器，导致`ServletWebServerFactory`无法正常实例化。这会使得应用程序无法启动Web容器，从而抛出上述错误。 解决方法是确保项目中包含正确的Servlet依赖，例如通过引入`spring-boot-starter-web`依赖，它会自动引入所需的Servlet API及相关组件。若确实不需要Servlet支持，则应调整为非Web应用类型，例如使用`spring-boot-starter`而非`spring-boot-starter-web`。

Answer 1

1. 问题概述

在Spring Boot项目中，如果排除`javax.servlet`依赖，运行时会出现“missing ServletWebServerFactory bean”的错误。这一问题的根本原因在于，Spring Boot的嵌入式Web服务器（如Tomcat、Jetty）需要依赖Servlet API来配置和初始化。

`ServletWebServerFactory`是Spring Boot用于创建嵌入式Web服务器的关键组件，而它本身又依赖于Servlet API中的类和接口。当`javax.servlet`被排除后，Spring Boot无法找到必要的Servlet类，导致`ServletWebServerFactory`无法正常实例化，进而使得应用程序无法启动Web容器。

常见技术问题分析

• 为什么`ServletWebServerFactory`与Servlet API密切相关？
• 如何正确引入Servlet依赖以避免该问题？
• 如果不使用Servlet支持，如何调整项目类型？

2. 问题深入分析

为了更好地理解这个问题，我们需要从以下几个方面进行分析：

分析角度	详细说明
Servlet规范的作用	Servlet规范定义了Java Web应用的核心API，包括请求/响应处理、会话管理等功能。
Spring Boot的自动配置机制	Spring Boot通过自动配置机制检测项目中的依赖，并根据这些依赖加载相应的组件。例如，`spring-boot-starter-web`会触发嵌入式Web服务器的配置。
排除`javax.servlet`的影响	一旦排除`javax.servlet`，Spring Boot将无法找到必要的Servlet类，从而导致`ServletWebServerFactory`无法正常工作。

3. 解决方案

为了解决“missing ServletWebServerFactory bean”的问题，可以采取以下两种方法：

1. 确保包含正确的Servlet依赖：通过引入`spring-boot-starter-web`依赖，Spring Boot会自动引入所需的Servlet API及相关组件。示例代码如下：

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

1. 调整为非Web应用类型：如果项目确实不需要Servlet支持，可以使用`spring-boot-starter`而非`spring-boot-starter-web`，并移除所有与Web相关的依赖。这样可以避免Spring Boot尝试加载嵌入式Web服务器。

以下是项目结构调整的流程图：

graph TD
            A[初始状态] --> B{是否需要Servlet支持}
            B --是--> C[引入spring-boot-starter-web]
            B --否--> D[使用spring-boot-starter]
            C --> E[正常启动Web应用]
            D --> F[运行非Web应用]

4. 总结与扩展思考

通过上述分析可以看出，`javax.servlet`依赖在Spring Boot Web应用中扮演着至关重要的角色。无论是Servlet规范的核心API，还是Spring Boot的自动配置机制，都离不开这一依赖的支持。

对于5年以上的从业者来说，除了解决具体问题外，还可以进一步思考以下扩展话题：

• 如何在微服务架构中合理划分Web与非Web模块？
• 在无服务器（Serverless）架构中，是否仍然需要Servlet支持？
• 未来Java EE向Jakarta EE迁移过程中，Servlet API的变化对Spring Boot项目有何影响？