springboot 404_Spring Boot(四) 异常处理

一、参数校验错误

1. 注解校验注解校验的常见形式是,在JavaBean类中添加javax.validation校验注解,在控制器方法参数前添加@Validated注解,当Spring MVC将请求参数解析为控制器方法参数时会触发校验:
@Datapublic class User {    @NotEmpty    private String name;    @Email    private String email;}@Controller@RequestMapping("/user")public class UserController {    @PostMapping    public String create(@Validated User user) {        // other code        return "success-page";    }}

当参数校验失败时,默认会抛出BindingException异常。可以选择全局处理该异常,但更简单灵活的方法是使用绑定结果上下文BindingResult。在具有@Validated注解的参数后定义BindingResult参数,Spring MVC便会将校验结果保存在该参数中,而不是抛出异常。随后,可以在控制器方法中获取校验结果并处理它:

@PostMappingpublic String create(@Validated User user, BindingResult br) {    // 如果参数无效,则转发至当前页面    if(br.hasErrors()) {        return "user-registration";    }    // other code    return "success-page";}
BindingResult实例会自动保存在Model中。使用模板引擎时,可以在模板中轻松获取并渲染错误信息。例如在thymeleaf模板中,使用下述模板语法判断是否校验失败,并显示所有错误信息:
if="${#fields.hasErrors('*')}"> "err : ${#fields.errors('*')}" th:text="${err}">

或是为输入非法值的文本框添加一个错误CSS类,并在文本框下显式对应的错误信息:

type=
"*{name}">

2. 业务校验

注解校验足够简洁易用,但不适合处理复杂的校验逻辑。当业务逻辑复杂时,不可避免的需要编写额外的校验代码。当校验失败时,可以向BindingResult注入错误信息,使自定义的校验代码与注解校验统一:

@PostMappingpublic String create(@Validated User user, BindingResult br) {    // 如果参数无效,则转发至当前页面    if (br.hasErrors()) {        return "user-registration";    }    if ("张三".equals(user.getName())) {        // 注入与字段相关的错误消息        br.rejectValue("name", "FIELD-MSG-0001");        return "user-registration";    }    if ("李四".equals(user.getName()) && Objects.isNull(user.getEmail())) {        // 注入全局的错误消息        br.reject("GLOBAL-MSG-0001");        return "user-registration";    }    // other code    return "success-page";}

BindingResult会在MessageSource中找到错误码对应的消息:

# messages.propertiesFIELD-MSG-0001      = 张三被系统拉黑了。GLOBAL-MSG-0001     = 李四没有邮箱。

二、 业务层异常

每个业务层方法通常是一个事务单元。在业务校验失败时,需要抛出异常回滚事务:

@Getterpublic class BussinessException extends RuntimeException {  private static final long serialVersionUID = -3087418646815345707L;  private String errorCode;  public BussinessException(String errorCode) {    super("发生了业务异常:" + errorCode);    this.errorCode = errorCode;  }}@Servicepublic class UserService {        @Autowired    private UserMapper mapper;        @Transactional    public void createUser(User user) {        User existingUser = mapper.selectByName(user.getName());        if(Objects.nonNull(existingUser)) {            throw new BusinessException("BUSINESS-ERROR-0001");        }        mapper.insert(user);    }}
如果不显式的捕获异常,Spring MVC 会丢弃当前的Model,防止处于错误状态的数据被继续使用。接下来,Spring Boot会将请求转发到错误页面,并将状态码设定为500。对于有状态服务端,如果只是希望停留在当前页面,并向用户反馈错误信息,需要在Web层显式的捕获异常并处理:
@PostMappingpublic String create(@Validated User user, BindingResult br) {    if (br.hasErrors()) {        return "user-registration";    }    // 发生业务异常时,注入错误消息,转发至当前页面    try {        service.createUser(user);    } catch (BusinessException e) {        br.reject(e.getErrorCode());        return "user-registration";    }    // other code    return "success-page";}

三、全局异常Spring Boot提供了异常处理控制器BasicErrorController映射到/error,它以一种明智的方式处理从Web层抛出的异常:对于媒体类型为HTML的请求,它将返回错误页面;如果是其他的媒体类型(通常是JSON),它将返回JSON格式的错误信息。 1、定制错误页面首先在控制器中写一段会抛出空指针异常的代码:
@PostMappingpublic String create(User user) {    String a = null;    a.getBytes();    return "success-page";}
以post方法访问/user,该控制器抛出空指针异常后,请求被转发至/error,由BasicErrorCo ntroller处理,返回whitelabel视图作为错误页面: 999220574b71589f0b9d2ff7b0124643.png

这是由于BasicErrorController在创建错误视图时,资源路径下寻找名为error.html的视图文件。如果没有找到,则返回“whitelabel”视图。因此,可以通过提供error.html定制错误页面的视图:

<html xmlns:th="http://www.thymeleaf.org"><head>  <title>自定义的错误页面title>head><body><h1>status: [[${status}]]h1><h5>错误信息:[[${message}]]h5>body>html>

重启服务后,再次以post方法访问/user,会返回定制的错误页面:

8761cc6218599c55996a66a840f44585.png

视图文件既可以是存放于templates目录下的模板文件,也可以是存放在static目录下的静态html文件。Spring Boot还提供了错误视图解析器DefaultErrorViewResolver,用于根据 Http状态码使用不同的错误视图。 DefaultErrorViewResolver在/templates/error或/static/error下匹配视图,具有两种匹配模式:
  • 视图文件名是具体的Http状态码。例如404.html,当发生404错误时,使用该视图文件。

  • 视图文件名以某一类Http状态码开头,例如5xx.html。当发生5开头的错误时(例如500),使用该视图文件。

在templates下创建错误视图目录error,在error下创建404错误专用的视图模板404.html,和5开头的错误通用的视图模板5xx.html:
<html xmlns:th="http://www.thymeleaf.org"><head>  <title>404title>head><body>页面未找到!body>html><html xmlns:th="http://www.thymeleaf.org"><head>  <title>5xxtitle>head><body>服务端错误:[[${status}]]body>html>
启动服务,访问不存在的路径时,显示404页面: a21af87c826156d9cf57ae56072e1700.png以post方法访问/user,显示5xx页面: 0ef2543bc0c48e8526aded979717384b.png综上所述,当发生异常时,Spring Boot首先根据Http状态码寻找匹配的视图,如果没找到,再寻找名为error的视图,如果仍没有找到,则返回 whi t elabel视图。 2、JSON响应当Content-Type为application/json的 请求发生异常时,Spring Boot将响应JSON格式的错误信息。使用JQuery的ajaxError函数处理全局ajax异常:
    $( document ).ajaxError(function( event, request, settings, thrownError) {      var res = request.responseJSON;      // 在body中输出json错误信息      $('body').html('
'
+ JSON.stringify(res, null, 4) + ' });

创建submit事件监听器,向/user发起ajax请求:

    $(document).on('submit', function() {        $.ajax({            type: "POST",            url: 'user',            contentType: "application/json; charset=utf-8",            data: JSON.stringify({}),            success: function (res) {                alert("成功!");            }        });        return false;    });

提交后,请求被转发至/error由BasicErrorController处理,它将响应json格式的错误信息:

684635e8d5cdfc1f84fe56b89123f3ec.png
四、处理特定异常

在具有@Controller或@ControllerAdvice注解的类中,可以使用@ExceptionHandler定制特定于某种异常的处理,而不是使用BasicErrorController。

例如,发生特定异常时,在跳转到错误页面前打印日志:

@ControllerAdvice@Slf4jpublic class GlobalControllerAdvice {  @Autowired private MessageSource messageSource;  @ExceptionHandler(BussinessException.class)  public String handleBussinessException(      BussinessException e, HandlerMethod method, Locale locale) {    var methodName = method.getShortLogMessage();    var exName = e.getClass().getName();    log.warn(MessageFormat.format("在{0}中发生了{1}异常", methodName, exName));    var errorCode = e.getErrorCode();    var message = messageSource.getMessage(e.getErrorCode(), null, locale);    log.warn(MessageFormat.format("[{0}]{1}", errorCode, message));    return "/bussiness-error";  }}

发生异常时,将打印下述log:

2020-11-14 17:07:24.423  WARN 15768 --- [nio-8080-exec-3] c.c.w.d.w.c.GlobalControllerAdvice       : 在com.cn.wjw.demo.web.controller.UserController#create[0 args]中发生了com.cn.wjw.demo.exception.BussinessException异常2020-11-14 17:07:24.423  WARN 15768 --- [nio-8080-exec-3] c.c.w.d.w.c.GlobalControllerAdvice       : [E00001]其他用户已经更新了数据,请刷新页面。

当然,也可以继续利用BasicErrorController,但在向客户端响应之前做额外的处理。只需要在@ExceptionHandler中实现额外的处理,最后将请求转发到/error,或是将正在处理的异常重新抛出:

  @ExceptionHandler(Throwable.class)  public void handleException(Throwable t) throws Throwable {    // TODO 在这里实现额外的逻辑,然后重新抛出异常    throw t;  }
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
如果你的Spring Boot全局异常处理对于404错误不生效,可能是因为404错误并不会触发异常处理器。404错误表示请求的资源未找到,而不是一个异常。因此,全局异常处理器对于404错误不会起作用。 要处理404错误,你可以使用Spring Boot提供的其他机制,如自定义错误页面或使用`@ControllerAdvice`注解结合`@ExceptionHandler`方法来处理。 1. 自定义错误页面:在Spring Boot中,你可以创建一个自定义的错误页面来显示404错误。首先,在`src/main/resources/static`目录下创建一个名为`error`的文件夹,然后在该文件夹下创建一个名为`404.html`的HTML文件。当发生404错误时,Spring Boot将自动跳转到该错误页面。 2. 使用`@ControllerAdvice`和`@ExceptionHandler`:创建一个带有`@ControllerAdvice`注解的类,并在该类中定义一个带有`@ExceptionHandler`注解的方法来处理404错误。示例代码如下所示: ```java @ControllerAdvice public class GlobalExceptionHandler { @ExceptionHandler(value = {NotFoundException.class}) public ResponseEntity<String> handleNotFoundException(NotFoundException ex) { return ResponseEntity.status(HttpStatus.NOT_FOUND).body("Resource not found"); } } ``` 在上面的示例中,我们定义了一个`handleNotFoundException`方法来处理`NotFoundException`异常(该异常可以是自定义的)。当发生404错误时,该方法将返回一个包含自定义错误消息的HTTP响应。 请注意,以上解决方案是针对处理404错误的常见方法。如果你有其他特定的需求或问题,请提供更多的细节,以便我可以给出更具体的建议。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值