SpringBoot应用无前端代码却自动打开首页问题求助

1. 检查依赖中的默认页面组件 #

部分Spring Boot starter或模板引擎依赖会自带欢迎页逻辑，即便本地无前端文件也可能触发：

• 打开pom.xml（Maven）或build.gradle（Gradle），移除未使用的模板引擎依赖，比如没用Thymeleaf就删除：

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

2. 彻底清理构建缓存与产物 #

• Maven执行：mvn clean install，清空target目录后重新构建
• Gradle执行：gradle clean build，清空build目录
• IDE层面清理缓存，比如IntelliJ IDEA通过File -> Invalidate Caches...清理后重启

3. 排查构建产物中的残留文件 #

Spring Boot会默认识别静态资源目录下的index.html为欢迎页，可能构建产物中仍有残留：

• 直接查看target/classes/static或target/classes/public目录，若存在旧index.html手动删除后重新构建

4. 检查自定义配置与硬编码逻辑 #

• 查看项目中是否有WebMvcConfigurer实现类，或通过@Bean注册的欢迎页相关配置
• 检查控制器中是否存在硬编码的默认路径跳转，比如：

@GetMapping("/")
public String index() {
    return "old-index";
}

5. 禁用欢迎页自动配置 #

在主启动类中直接禁用Spring Boot的欢迎页自动配置类：

@SpringBootApplication(exclude = {WelcomePageAutoConfiguration.class})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

新页面无效的补充排查 #

• 调整页面放置路径：Spring Boot默认识别src/main/resources/static、src/main/resources/public等目录，webapp/WEB-INF需手动配置视图解析器才会生效，建议将页面移至static目录
• 若使用模板引擎，确认application.properties配置正确，比如Thymeleaf：

spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html

内容的提问来源于stack exchange，提问作者lahariN