Spring MVC全局异常后返回JSON异常数据

左手的ㄟ右手 2022-03-18 21:35 309阅读 0赞

## 问题： ##

当前项目是作为手机APP后台支持，使用[spring][] mvc + mybaits + shiro进行开发。后台服务与手机端交互是发送JSON数据。如果后台发生异常，会直接返回异常页面，显示异常内容，如果是404请求不到资源或者500这类服务器的问题，可能会导致返回404和500异常页面，手机端的处理就非常麻烦，为了解决这个问题，就需要做全局的异常处理。

## 解决方案： ##

### （1）自定义或者使用spring自带的各种异常处理器 ###

例如spring基于注解的异常解析器AnnotationHandlerMethodExceptionResolver 、spring自带全局异常处理器SimpleMappingExceptionResolver、自定义实现spring的全局异常解析器HandlerExceptionResolver来处理。

AnnotationHandlerMethodExceptionResolver目前我所知道的是需要在方法上定义异常的类型，如果异常类型多了，写起代码太麻烦，所以我认为不好用。（那位大侠知道不用定义异常类型就处理所有异常，可以留言告诉我，谢谢！）

spring自带全局异常处理器SimpleMappingExceptionResolver也是比较繁琐的，需要配置的地方太多了，不喜欢用。

自定义实现spring的全局异常解析器HandlerExceptionResolver来处理我认为是最方便的，当然，这个是针对我目前的业务场景而言，并不是绝对的。

由于[Java][spring]的异常机制，如果发生大量异常，对jvm的性能会产生很大的影响，轻则性能下降10%，重则导致jvm内存溢出，我个人认为能不抛异常就最好不抛，所以，我主要使用自定义实现spring的全局异常解析器HandlerExceptionResolver来处理业务问题。

#### （2）自定义实现spring的全局异常解析器HandlerExceptionResolver    ####

2.1 只需要在spring-mvc的配置文件中定义一个全局异常处理类

**\[html\]**  [view plain][]   [copy][view plain]

[print][view plain][?][view plain]

1.    
2.  <bean id="exceptionHandler" class="com.aaa.bbb.exception.DefaultExceptionHandler" />

2.2  实现HandlerExceptionResolver（第一种实现方式）

这种方式需要下载温少写的fastjson，我用的是1.2.6版本，可以百度后自己下载。

**\[java\]**  [view plain][]   [copy][view plain]

[print][view plain][?][view plain]

1.  public class DefaultExceptionHandler implements HandlerExceptionResolver \{    
2.      private static Logger log = LoggerFactory.getLogger(DefaultExceptionHandler.class);  
3.        
4.      public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler,  Exception ex) \{    
5.              ModelAndView mv = new ModelAndView();  
6.              /\*  使用FastJson提供的FastJsonJsonView视图返回，不需要捕获异常   \*/  
7.              FastJsonJsonView view = new FastJsonJsonView();  
8.              Map<String, Object> attributes = new HashMap<String, Object>();  
9.              attributes.put("code", "1000001");  
10.             attributes.put("msg", ex.getMessage());  
11.             view.setAttributesMap(attributes);  
12.             mv.setView(view);   
13.             log.debug("异常:" + ex.getMessage(), ex);  
14.             return mv;  
15.     \}  
16. \}

2.2  实现HandlerExceptionResolver（第二种实现方式）

**\[java\]**  [view plain][]   [copy][view plain]

[print][view plain][?][view plain]

1.  public class DefaultExceptionHandler implements HandlerExceptionResolver \{    
2.      private static Logger log = LoggerFactory.getLogger(DefaultExceptionHandler.class);  
3.        
4.      public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler,  Exception ex) \{    
5.              ModelAndView mv = new ModelAndView();             
6.              /\*  使用response返回    \*/  
7.              response.setStatus(HttpStatus.OK.value()); //设置状态码  
8.              response.setContentType(MediaType.APPLICATION\_JSON\_VALUE); //设置ContentType  
9.              response.setCharacterEncoding("UTF-8"); //避免乱码  
10.             response.setHeader("Cache-Control", "no-cache, must-revalidate");  
11.             try \{  
12.                 response.getWriter().write("\{\\"success\\":false,\\"msg\\":\\"" + ex.getMessage() + "\\"\}");  
13.             \} catch (IOException e) \{  
14.                log.error("与客户端通讯异常:"+ e.getMessage(), e);  
15.             \}  
16.   
17.             log.debug("异常:" + ex.getMessage(), ex);  
18.             return mv;  
19.     \}  
20. \}

到此，spring mvc全局异常处理返回json就搞定了，发生异常后，返回的都是json数据，不会再有烦人的异常内容。不过这还不算完整，需要在web.xml中加入异常代码404或者500的处理才能算完。

（1）web页面异常处理配置

1.1  <exception-type>java.lang.Throwable</exception-type>表示发生java.lang.Throwable类型的异常，<location>/error\_500</location>表示到/error\_500地址处理，

例如用户请求【http://www.a.com/user/login/getUser】 ，应用名称是user，如果请求发生java.lang.Throwable，那么请求会转到【http://www.a.com/user/error\_500】

1.2 <error-code>404</error-code>表示发生404请求失败，<location>/error\_404</location>表示到/error\_404处理，

例如用户请求【http://www.a.com/user/login/getUser】，应用名称是user ，如果用户请求发生404异常，请求资源找不到，那么请求会转到【http://www.a.com/user/error\_404】

**\[html\]**  [view plain][]   [copy][view plain]

[print][view plain][?][view plain]

1.    
2.  <error-page>  
3.      <exception-type>java.lang.Throwable</exception-type>  
4.      <location>/error\_500</location>  
5.  </error-page>  
6.  <error-page>  
7.      <exception-type>java.lang.Exception</exception-type>  
8.      <location>/error\_404</location>  
9.  </error-page>  
10. <error-page>  
11.     <error-code>500</error-code>  
12.     <location>/error\_500</location>  
13. </error-page>  
14. <error-page>  
15.     <error-code>501</error-code>  
16.     <location>/error\_500</location>  
17. </error-page>  
18. <error-page>  
19.     <error-code>502</error-code>  
20.     <location>/error\_500</location>  
21. </error-page>  
22. <error-page>  
23.     <error-code>404</error-code>  
24.     <location>/error\_404</location>  
25. </error-page>  
26. <error-page>  
27.     <error-code>403</error-code>  
28.     <location>/error\_404</location>  
29. </error-page>  
30. <error-page>  
31.     <error-code>400</error-code>  
32.     <location>/error\_404</location>  
33. </error-page>

（2）后台处理

如果发生以上异常，请求会转到【http://www.a.com/user/error\_404】，那么在后台就需要做相应的处理，处理方式就是在Controller层定义处理异常的方法

**\[java\]**  [view plain][]   [copy][view plain]

[print][view plain][?][view plain]

1.  /\*\* 
2.   \* 请求异常 
3.   \* @return 
4.   \* @throws Exception 
5.   \* String 
6.   \*/  
7.  @RequestMapping(value = "/error\_404", produces = "text/html;charset=UTF-8")  
8.  @ResponseBody  
9.  public String error\_404() throws Exception \{   
10.      return "\{\\"msg\\":\\"找不到页面\\",\\"code\\":\\"1000001\\"\}";  
11. \}  
12. /\*\* 
13.  \* 服务器异常 
14.  \* @return 
15.  \* String 
16.  \*/  
17. @RequestMapping(value ="/error\_500", produces = "text/html;charset=UTF-8")  
18. public String error\_500() \{     <pre name="code" class="java">                return "\{\\"msg\\":\\"服务器处理失败\\",\\"code\\":\\"1000002\\"\}";  
19. \}

最后，基本上所有的异常都能被捕获，能够出现异常时，友好的提示用户端，也能避免服务器端抛异常导致的问题。

分类: [Java][]

好文要顶 关注我 收藏该文 ![Image 1][] ![Image 1][]

[![Image 1][]][Image 1 1]

[\_再见理想][Image 1 1]  
[关注 - 4][- 4]  
[粉丝 - 235][- 235]

\+加关注

[« ][Link 1] 上一篇： [spring mvc 异常统一处理方式][Link 1]  
[» ][Link 2] 下一篇： [Spring全局异常捕获][Link 2]

</div>

[spring]: http://lib.csdn.net/base/javaee
[view plain]: http://blog.csdn.net/chwshuang/article/details/48089203
[Java]: https://www.cnblogs.com/exmyth/category/429900.html
[Image 1]: 
[Image 1 1]: http://home.cnblogs.com/u/exmyth/
[- 4]: http://home.cnblogs.com/u/exmyth/followees
[- 235]: http://home.cnblogs.com/u/exmyth/followers
[Link 1]: https://www.cnblogs.com/exmyth/p/5600973.html
[Link 2]: https://www.cnblogs.com/exmyth/p/5604046.html