SpringBoot出现Whitelabel Error Page问题的解决办法(特殊情况)-优快云博客

本文链接：https://blog.youkuaiyun.com/Zerone_1/article/details/118765552

本文介绍了SpringBoot运行时出现WhitelabelErrorPage错误的两种常见原因及其解决方案。一是文件目录结构不正确，需要确保带有注解的Controller在正确的位置，或者使用@ComponentScan显式指定扫描路径。二是端口号冲突，可通过修改application.properties文件中的server.port来避免。此外，还提供了端口被占用时的解决方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

SpringBoot出现Whitelabel Error Page问题的解决办法(特殊情况)

在这里插入图片描述
若解除端口号之后，首次运行成功，第二次仍占用请点击这篇文章：因tomcat重复集成导致端口号被占用

1.第一种情况，文件目录建立不当

**这种情况比较常见，当我出现问题时，百度大部分结果就是在解决文件目录问题，我也稍微提一下。**

spring传统写法：org.sl.springboot.HelloWorld.controller手写到scan扫描器中(即加入spring容器)
spring boot自动配置：将org.sl.springboot.HelloWorld和org.sl.springboot.HelloWorld.xxx纳入spring容器

项目结构目录
具有主入口启动页Application的位置必须大于等于包含Conrtroller的包,也就是下面图片的样子

树型目录
这样在启动的时候，Springboot才会自动扫描带有注解的Controller,如果不在此位置，将不会扫描到，需要加注解进行扫描

@SpringBootApplication
@ComponentScan(basePackages="org.sl.springboot.HelloWorld.controller")
public class HelloWorldApplication {

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

}

其中@ComponentScan(basePackages=“controller所在包名”)