一、参数校验错误

1. 注解校验注解校验的常见形式是&＃xff0c;在JavaBean类中添加javax.validation校验注解&＃xff0c;在控制器方法参数前添加&＃64;Validated注解&＃xff0c;当Spring MVC将请求参数解析为控制器方法参数时会触发校验&＃xff1a;

&＃64;Datapublic class User { &＃64;NotEmpty private String name; &＃64;Email private String email;}&＃64;Controller&＃64;RequestMapping("/user")public class UserController { &＃64;PostMapping public String create(&＃64;Validated User user) { // other code return "success-page"; }}

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

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

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

type&＃61;

2. 业务校验

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

&＃64;PostMappingpublic String create(&＃64;Validated User user, BindingResult br) { // 如果参数无效&＃xff0c;则转发至当前页面 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中找到错误码对应的消息&＃xff1a;

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

---

二、 业务层异常

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

&＃64;Getterpublic class BussinessException extends RuntimeException { private static final long serialVersionUID &＃61; -3087418646815345707L; private String errorCode; public BussinessException(String errorCode) { super("发生了业务异常&＃xff1a;" &＃43; errorCode); this.errorCode &＃61; errorCode; }}&＃64;Servicepublic class UserService { &＃64;Autowired private UserMapper mapper; &＃64;Transactional public void createUser(User user) { User existingUser &＃61; mapper.selectByName(user.getName()); if(Objects.nonNull(existingUser)) { throw new BusinessException("BUSINESS-ERROR-0001"); } mapper.insert(user); }}如果不显式的捕获异常&＃xff0c;Spring MVC会丢弃当前的Model&＃xff0c;防止处于错误状态的数据被继续使用。接下来&＃xff0c;Spring Boot会将请求转发到错误页面&＃xff0c;并将状态码设定为500。对于有状态服务端&＃xff0c;如果只是希望停留在当前页面&＃xff0c;并向用户反馈错误信息&＃xff0c;需要在Web层显式的捕获异常并处理&＃xff1a;

&＃64;PostMappingpublic String create(&＃64;Validated User user, BindingResult br) { if (br.hasErrors()) { return "user-registration"; } // 发生业务异常时&＃xff0c;注入错误消息&＃xff0c;转发至当前页面 try { service.createUser(user); } catch (BusinessException e) { br.reject(e.getErrorCode()); return "user-registration"; } // other code return "success-page";}

---

三、全局异常Spring Boot提供了异常处理控制器BasicErrorController映射到/error&＃xff0c;它以一种明智的方式处理从Web层抛出的异常&＃xff1a;对于媒体类型为HTML的请求&＃xff0c;它将返回错误页面&＃xff1b;如果是其他的媒体类型(通常是JSON)&＃xff0c;它将返回JSON格式的错误信息。1、定制错误页面首先在控制器中写一段会抛出空指针异常的代码:

&＃64;PostMappingpublic String create(User user) { String a &＃61; null;    a.getBytes(); return "success-page";}以post方法访问/user&＃xff0c;该控制器抛出空指针异常后&＃xff0c;请求被转发至/error&＃xff0c;由BasicErrorController处理&＃xff0c;返回whitelabel视图作为错误页面&＃xff1a;

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

自定义的错误页面title>head>

status: [[${status}]]h1>

错误信息&＃xff1a;[[${message}]]h5>body>html>

重启服务后&＃xff0c;再次以post方法访问/user&＃xff0c;会返回定制的错误页面&＃xff1a;

视图文件既可以是存放于templates目录下的模板文件&＃xff0c;也可以是存放在static目录下的静态html文件。Spring Boot还提供了错误视图解析器DefaultErrorViewResolver&＃xff0c;用于根据Http状态码使用不同的错误视图。DefaultErrorViewResolver在/templates/error或/static/error下匹配视图&＃xff0c;具有两种匹配模式&＃xff1a;

• 视图文件名是具体的Http状态码。例如404.html&＃xff0c;当发生404错误时&＃xff0c;使用该视图文件。

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

在templates下创建错误视图目录error&＃xff0c;在error下创建404错误专用的视图模板404.html&＃xff0c;和5开头的错误通用的视图模板5xx.html&＃xff1a;

404title>head>页面未找到&＃xff01;body>html> 5xxtitle>head>服务端错误&＃xff1a;[[${status}]]body>html>启动服务&＃xff0c;访问不存在的路径时&＃xff0c;显示404页面&＃xff1a;以post方法访问/user&＃xff0c;显示5xx页面&＃xff1a;综上所述&＃xff0c;当发生异常时&＃xff0c;Spring Boot首先根据Http状态码寻找匹配的视图&＃xff0c;如果没找到&＃xff0c;再寻找名为error的视图&＃xff0c;如果仍没有找到&＃xff0c;则返回whitelabel视图。2、JSON响应当Content-Type为application/json的请求发生异常时&＃xff0c;Spring Boot将响应JSON格式的错误信息。使用JQuery的ajaxError函数处理全局ajax异常&＃xff1a;

$( document ).ajaxError(function( event, request, settings, thrownError) { var res &＃61; request.responseJSON; // 在body中输出json错误信息 $(&＃39;body&＃39;).html(&＃39;

&＃39; &＃43; JSON.stringify(res, null, 4) &＃43; &＃39; });

创建submit事件监听器&＃xff0c;向/user发起ajax请求&＃xff1a;

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

提交后&＃xff0c;请求被转发至/error由BasicErrorController处理&＃xff0c;它将响应json格式的错误信息&＃xff1a;

---

四、处理特定异常

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

例如&＃xff0c;发生特定异常时&＃xff0c;在跳转到错误页面前打印日志&＃xff1a;

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

发生异常时&＃xff0c;将打印下述log&＃xff1a;

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]其他用户已经更新了数据&＃xff0c;请刷新页面。

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

&＃64;ExceptionHandler(Throwable.class) public void handleException(Throwable t) throws Throwable { // TODO 在这里实现额外的逻辑&＃xff0c;然后重新抛出异常 throw t; }