SpringBoot2启动时提示“No Spring WebApplicationInitializer types detected on classpath”如何解决？

Question

在SpringBoot2项目启动时，如果遇到“No Spring WebApplicationInitializer types detected on classpath”提示，通常是由于项目中缺少必要的Web依赖或配置错误导致。解决方法如下：首先确认`pom.xml`或`build.gradle`文件中是否正确引入了Spring Boot Web Starter依赖，如`spring-boot-starter-web`。此依赖包含构建Web应用所需的全部组件。如果已正确引入依赖但问题依旧存在，检查是否误将Spring Boot应用配置为传统Servlet初始化模式。确保主类使用`@SpringBootApplication`注解，并包含`public static void main(String[] args)`方法启动Spring Boot应用上下文。此外，避免手动实现`WebApplicationInitializer`接口，因为Spring Boot会自动配置嵌入式容器。最后，清理并重新构建项目（如执行`mvn clean install`或`gradle clean build`），以排除缓存或构建过程中的潜在问题。通过以上步骤，通常可有效解决该问题。

Answer 1

1. 问题概述

在Spring Boot 2项目启动时，如果遇到“No Spring WebApplicationInitializer types detected on classpath”提示，通常表明项目中缺少必要的Web依赖或存在配置错误。以下是针对该问题的逐步分析与解决方案。

此问题可能涉及以下方面：

• 依赖未正确引入
• 应用配置不正确
• 构建过程中的缓存问题

2. 检查依赖配置

首先确认`pom.xml`或`build.gradle`文件中是否正确引入了Spring Boot Web Starter依赖。

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

对于Gradle用户：

implementation 'org.springframework.boot:spring-boot-starter-web'

确保上述依赖已正确添加至项目配置文件中，并且版本与Spring Boot主版本匹配。

3. 检查应用配置

如果依赖已正确引入但问题依旧存在，检查是否误将Spring Boot应用配置为传统Servlet初始化模式。

检查项	描述
主类注解	确保主类使用`@SpringBootApplication`注解
启动方法	确保主类包含`public static void main(String[] args)`方法

避免手动实现`WebApplicationInitializer`接口，因为Spring Boot会自动配置嵌入式容器。

4. 清理并重新构建项目

执行以下命令以清理并重新构建项目：

mvn clean install

或者对于Gradle项目：

gradle clean build

通过以上步骤，可以排除缓存或构建过程中的潜在问题。

5. 解决流程图

以下是解决该问题的流程图：

graph TD
            A[问题出现] --> B{依赖是否正确}
            B --否--> C[检查pom.xml或build.gradle]
            B --是--> D{配置是否正确}
            D --否--> E[检查主类和注解]
            D --是--> F{构建是否有问题}
            F --是--> G[清理并重新构建]
            F --否--> H[问题解决]