### Spring Boot
Whitelabel Error Page 解决方案
Spring Boot 的
Whitelabel Error Page 是默认的错误页面，当应用程序中发生未处理的异常时会显示该页面。以下是一些解决方案和原因分析：
#### 1. **自定义全局错误处理**
可以通过实现 `
ErrorController` 接口来自定义错误页面。创建一个类并实现 `
ErrorController` 接口，重写 `get
ErrorPath` 和 `
error` 方法[^1]。
例如：
```java
import org.springframework.boot.web.
error.
ErrorAttributeOptions;
import org.springframework.boot.web.servlet.
error.
ErrorController;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.RequestDispatcher;
import javax.servlet.http.HttpServletRequest;
import java.util.Map;
@RestController
public class Custom
ErrorController implements
ErrorController {
@RequestMapping("/
error")
public Map<String, Object> handle
Error(HttpServletRequest request) {
// 获取错误信息
ErrorAttributeOptions options =
ErrorAttributeOptions.defaults();
Map<String, Object>
errorAttributes = get
ErrorAttributes(request, options);
return
errorAttributes;
}
@Override
public String get
ErrorPath() {
return "/
error";
}
}
```
#### 2. **使用静态资源文件作为错误页面**
可以在 `src/main/resources/static` 目录下创建 HTML 文件来定义自定义错误页面。例如，创建一个名为 `
error.html` 的文件[^3]。
示例内容如下：
```html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>
Error Page</title>
</head>
<body>
<h1>An
error occurred!</h1>
<p>Please try again later.</p>
</body>
</html>
```
#### 3. **配置 `application.properties` 或 `application.yml`**
可以通过设置 `server.
error.
whitelabel.enabled=false` 来禁用
Whitelabel Error Page，并启用自定义错误页面[^1]。
例如，在 `application.properties` 中添加：
```properties
server.
error.
whitelabel.enabled=false
```
#### 4. **扩展 `Default
ErrorAttributes` 类**
如果需要自定义错误响应中的属性，可以扩展 `Default
ErrorAttributes` 类并注册为 Bean[^2]。
示例代码如下：
```java
import org.springframework.boot.web.servlet.
error.Default
ErrorAttributes;
import org.springframework.stereotype.Component;
import org.springframework.web.context.request.WebRequest;
import java.util.Map;
@Component
public class Custom
ErrorAttributes extends Default
ErrorAttributes {
@Override
public Map<String, Object> get
ErrorAttributes(WebRequest webRequest,
ErrorAttributeOptions options) {
Map<String, Object>
errorAttributes = super.get
ErrorAttributes(webRequest, options);
errorAttributes.put("customMessage", "This is a custom
error message.");
return
errorAttributes;
}
}
```
#### 5. **使用 `
ErrorPageRegistrar` 接口**
对于不使用 Spring MVC 的应用程序，可以使用 `
ErrorPageRegistrar` 接口直接注册错误页面。
示例代码如下：
```java
import org.springframework.boot.web.server.
ErrorPage;
import org.springframework.boot.web.server.
ErrorPageRegistrar;
import org.springframework.boot.web.server.
ErrorPageRegistry;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.HttpStatus;
@Configuration
public class
ErrorPageConfig {
@Bean
public
ErrorPageRegistrar
errorPageRegistrar() {
return new
ErrorPageRegistrar() {
@Override
public void register
ErrorPages(
ErrorPageRegistry registry) {
ErrorPage errorPage404 = new
ErrorPage(HttpStatus.NOT_FOUND, "/404.html");
ErrorPage errorPage500 = new
ErrorPage(HttpStatus.INTERNAL_SERVER_
ERROR, "/500.html");
registry.add
ErrorPages(
errorPage404,
errorPage500);
}
};
}
}
```
#### 6. **MyBatis 和 MyBatis-Plus 配置冲突**
如果项目中同时使用了 MyBatis 和 MyBatis-Plus，可能会导致某些异常未被捕获，从而触发
Whitelabel Error Page。确保 Mapper 文件路径正确配置，并在 `application.properties` 中指定 Mapper XML 文件的位置[^4]。
例如：
```properties
mybatis.mapper-locations=classpath*:mapper/*.xml
```
---
###
扫一扫
2634
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
