java Spring Boot自定义错误页面

在Spring Boot中自定义错误页面可以让应用程序在遇到特定HTTP错误状态码时,向用户展示更加友好和定制化的错误信息页面。

以下是几种常见的方法来实现这一功能:

1. 静态资源文件夹下的错误页面

Spring Boot默认会从src/main/resources/static/error或src/main/resources/public/error目录下查找错误页面。

需要按照HTTP状态码命名这些错误页面,例如,为了自定义404错误页面,可以创建一个名为404.html的文件在这个目录下。

2. 使用ErrorController

创建一个类实现ErrorController接口,覆盖其getErrorPath方法,并定义一个处理方法来返回自定义错误视图。

例如:

java 复制代码
import org.springframework.boot.web.servlet.error.ErrorController;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import javax.servlet.RequestDispatcher;
import javax.servlet.http.HttpServletRequest;

@Controller
public class CustomErrorController implements ErrorController {

    @RequestMapping("/error")
    public String handleError(HttpServletRequest request) {
        Object status = request.getAttribute(RequestDispatcher.ERROR_STATUS_CODE);

        if (status != null) {
            Integer statusCode = Integer.valueOf(status.toString());

            if (statusCode == HttpStatus.NOT_FOUND.value()) {
                return "error/404"; // 假设有在templates目录下的error/404.html
            } else if (statusCode == HttpStatus.INTERNAL_SERVER_ERROR.value()) {
                return "error/500"; // 同上,对应500错误页面
            }
            // 可以添加更多错误处理逻辑
        }
        return "error/default"; // 默认错误页面
    }

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

3. 使用@ExceptionHandler注解

在控制器类中,可以使用@ExceptionHandler注解来处理特定的异常,并返回自定义的视图。这种方式适用于处理特定业务异常。

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 = {NotFoundException.class})
    public ModelAndView handleNotFoundException(Exception e) {
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("errorMessage", e.getMessage());
        modelAndView.setViewName("error/404"); // 对应的错误页面
        return modelAndView;
    }
}

4. 配置Whitelabel Error Page

如果不希望使用Spring Boot默认的白色标签错误页面,可以在application.properties或application.yml中关闭它:

XML 复制代码
spring.mvc.throw-exception-if-no-handler-found=true
spring.resources.add-mappings=false
server.error.whitelabel.enabled=false
相关推荐
喵手6 分钟前
玩转Java网络编程:基于Socket的服务器和客户端开发!
java·服务器·网络
再见晴天*_*1 小时前
SpringBoot 中单独一个类中运行main方法报错:找不到或无法加载主类
java·开发语言·intellij idea
lqjun08273 小时前
Qt程序单独运行报错问题
开发语言·qt
hdsoft_huge4 小时前
Java & Spring Boot常见异常全解析:原因、危害、处理与防范
java·开发语言·spring boot
风中的微尘5 小时前
39.网络流入门
开发语言·网络·c++·算法
雨白5 小时前
Java 多线程指南:从基础用法到线程安全
android·java
Hungry_Shark5 小时前
IDEA版本控制管理之使用Gitee
java·gitee·intellij-idea
赛姐在努力.5 小时前
《IDEA 突然“三无”?三秒找回消失的绿色启动键、主菜单和项目树!》
java·intellij-idea
未来之窗软件服务5 小时前
幽冥大陆(二)RDIFSDK 接口文档:布草洗涤厂高效运营的技术桥梁C#—东方仙盟
开发语言·c#·rdif·仙盟创梦ide·东方仙盟
猎板PCB黄浩5 小时前
从废料到碳减排:猎板 PCB 埋容埋阻的绿色制造革命,如何实现环保与性能双赢
java·服务器·制造