前端页面Whitelabel Error Page怎么回事

### 出现Whitelabel Error Page的原因

当Spring Boot应用程序无法找到处理请求的控制器映射时，会显示默认的白标签错误页面。这通常是因为配置不当或路径设置不正确造成的。

#### 原因分析
- 控制器未被扫描到：如果启动类不在其他组件所在的父包中，则这些组件不会被自动检测并注册至上下文中[^4]。
- 请求路径不对：定义的方法对应的URL模式未能匹配实际发出的HTTP请求地址[^1]。
- 方法类型不符：警告日志表明服务器接收到的是`POST`请求而端点仅支持特定类型的调用方式，比如GET, POST等[^3]。

### 解决方案展示

针对上述提到的情况，以下是几种有效的解决策略：

#### 修改应用结构以确保所有必要的Java文件位于正确的目录下

为了使Spring Boot能够识别所有的Bean，建议将入口类放置于根包位置，并让其余功能模块作为其子包存在。例如项目应遵循如下布局：

src/main/java/com/example/demo/
├── DemoApplication.java (启动类)
└── controller/
    └── IndexController.java

#### 调整@RequestMapping注解中的value属性来适配预期的行为

对于简单的返回字符串响应场景可以采用@RestController简化开发流程；而对于HTML视图渲染则继续保留@Controller配合模板引擎使用。下面是一个基于REST风格的例子：

package com.example.demo.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class GreetingController {

    @GetMapping("/")
    public String greet() {
        return "Hello Spring Boot!";
    }
}

另外一种情况是保持原有@Controller的同时指定具体的访问路径名而非根路径"/":

package com.example.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class HtmlPageController {

    @RequestMapping("/greet")
    public String showGreeting(Model model){
        model.addAttribute("message", "Welcome to the world of Spring Boot!");
        return "index"; // 对应templates/index.html
    }
}

此时浏览器应当通过`http://localhost:8080/greet`去查看效果而不是直接打开首页。