如何在Spring Boot应用程序中配置自定义错误页面？

在Spring Boot中配置自定义错误页面是一种常见的需求，可以增强用户体验，通过友好的错误页面处理错误和异常情况。Spring Boot提供了多种方式来定制错误处理，包括基于错误视图解析、控制器和使用ErrorController。以下是几种配置自定义错误页面的方法：

1. 使用ErrorController

您可以通过实现ErrorController接口来创建一个自定义的错误处理控制器。这允许您在发生错误时执行自定义逻辑。

java
import org.springframework.boot.web.servlet.error.ErrorController;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class MyErrorController implements ErrorController {

    @RequestMapping("/error")
    public String handleError() {
        // 可以添加逻辑来处理不同的错误状态码
        return "errorPage"; // 返回到自定义的错误视图名称
    }

    @Override
    public String getErrorPath() {
        return "/error";
    }
}

在这个例子中，handleError() 方法被用来处理所有的错误，并将用户导向一个名为errorPage的视图（一个HTML页面、Thymeleaf模板等）。

2. 使用application.properties

在application.properties或application.yml中配置错误页面也是可能的。这种方法更简单，但不如使用控制器灵活。例如，您可以指定一个错误页面来处理所有404错误。

properties
server.error.whitelabel.enabled=false  # 关闭白页错误
server.error.404=/error-404.html

3. 使用Spring MVC的异常处理

您还可以利用Spring MVC的@ExceptionHandler注解来处理控制器中抛出的特定异常。结合@ControllerAdvice可以全局处理异常。

java
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.servlet.ModelAndView;

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(value = Exception.class) // 可以指定更具体的异常
    public ModelAndView defaultErrorHandler(Exception e) {
        ModelAndView mav = new ModelAndView("errorPage");
        mav.addObject("message", e.getMessage());
        return mav;
    }
}

在这个例子中，任何异常都会被defaultErrorHandler方法捕获，然后将用户重定向到errorPage视图，并传递异常消息。

结论

以上方法可以根据具体需要进行选择和组合。通过实现ErrorController提供最大的灵活性和控制，而使用属性文件配置则是最简单的方法。无论选择哪种方法，配置自定义错误页面都是提升应用程序用户体验的好方式。