SpringBoot项目运行时出现 Whitelabel Error Page 的原因及解决方法？

Question

在SpringBoot项目运行时，出现Whitelabel Error Page通常是因为控制器方法未正确映射或视图名称配置错误。例如，当请求的URL与任何@Controller中的方法不匹配时，SpringBoot会返回Whitelabel Error Page。 解决方法如下：首先检查控制器类是否使用了正确的注解（如@RestController或@Controller），并确保方法上有@RequestMapping或其他HTTP方法注解（如@GetMapping）。其次，确认路径是否正确，包括路径前缀和后缀。如果涉及视图解析，需检查视图名称是否与实际HTML文件名一致，并确保文件位于resources/templates目录下。此外，若使用的是REST API，应将返回值设为JSON格式数据而非视图名，此时使用@RestController注解更合适。最后，开启详细错误信息显示，可在application.properties中设置server.error.include-stacktrace=always以获取更多调试信息。

Answer 1

1. 问题概述

在Spring Boot项目运行时，出现Whitelabel Error Page通常是因为控制器方法未正确映射或视图名称配置错误。这种错误表明服务器无法找到与请求URL匹配的资源。

例如，当请求的URL与任何@Controller中的方法不匹配时，Spring Boot会返回Whitelabel Error Page。以下是常见的技术问题及分析：

• 控制器类注解是否正确。
• 路径映射是否准确。
• 视图解析器配置是否正确。
• REST API返回值格式是否为JSON。

2. 常见问题分析

以下是一些可能导致Whitelabel Error Page的原因及其分析过程：

问题类型	可能原因	解决方案
控制器注解错误	@Controller 或 @RestController 注解使用不当	确保根据需求选择正确的注解：若需要返回视图，则使用@Controller；若需要返回JSON数据，则使用@RestController。
路径映射错误	方法上缺少@RequestMapping或其他HTTP方法注解（如@GetMapping）	检查每个控制器方法是否正确标注了路径映射注解。
视图解析错误	视图名称与HTML文件名不一致或文件位置错误	确保HTML文件位于resources/templates目录下，并且视图名称与文件名一致。

3. 解决方案

以下是解决Whitelabel Error Page的具体步骤：

1. 检查控制器注解：确认控制器类是否使用了正确的注解（@Controller 或 @RestController）。
2. 验证路径映射：确保方法上有@RequestMapping或其他HTTP方法注解（如@GetMapping），并检查路径是否正确，包括前缀和后缀。
3. 检查视图解析：如果涉及视图解析，需确认视图名称是否与实际HTML文件名一致，并确保文件位于resources/templates目录下。
4. 调整REST API返回值：如果是REST API，应将返回值设为JSON格式数据而非视图名，此时使用@RestController注解更合适。
5. 开启详细错误信息显示：在application.properties中设置server.error.include-stacktrace=always以获取更多调试信息。

4. 流程图示例

以下是解决Whitelabel Error Page的流程图：

graph TD;
            A[出现Whitelabel Error Page] --> B{控制器注解是否正确};
            B --否--> C{路径映射是否正确};
            C --否--> D{视图解析是否正确};
            D --否--> E{REST API返回值是否为JSON};
            E --否--> F[开启详细错误信息];