解决 Spring Boot 启动报错：“org.springframework.context.ApplicationContextException: Unable to start web server”

2024-01-16 04:18:10

Spring Boot Web 服务器启动失败：指南

问题概述

启动 Spring Boot 应用时，你可能会遇到这个恼人的错误：

org.springframework.context.ApplicationContextException: Unable to start web server; nested exception is org.springframework.context.ApplicationContextException: Unable to start ServletWebServerApplicationContext due to missing ServletWebServerFactory bean.

这意味着 Spring Boot 无法启动内置的 Web 服务器，通常是因为缺少一个名为 ServletWebServerFactory 的 bean。

解决步骤

1. 检查依赖项

在你的 pom.xml 文件中，确保你添加了 Spring Boot Web 依赖项：

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

2. 启用组件扫描

在你的 Spring Boot 主类中，确保启用了 Web 组件扫描：

@SpringBootApplication
@ComponentScan(basePackages = "com.example.myapp")
public class MyApplication {

    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

3. 自定义 ServletWebServerFactory

如果你使用自定义的 ServletWebServerFactory 实现，请在主类中配置它：

@SpringBootApplication
public class MyApplication {

    @Bean
    public ServletWebServerFactory servletWebServerFactory() {
        return new TomcatServletWebServerFactory();
    }

    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

4. 检查冲突

确保项目中没有冲突的 ServletWebServerFactory bean。如果有，删除它或解决冲突。

5. 检查版本兼容性

确保 Spring Boot 版本与 Servlet 容器兼容。例如，Spring Boot 2.x 需要 Servlet 3.1 或更高版本。

6. 嵌入式 Tomcat

如果你使用嵌入式 Tomcat 服务器，请在 pom.xml 中添加以下依赖项：

<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-core</artifactId>
    <version>9.0.63</version>
</dependency>