详解Spring全局异常处理的三种方式

发布时间 - 2026-01-11 00:35:19    点击率:

在J2EE项目的开发中,不管是对底层的数据库操作过程,还是业务层的处理过程,还是控制层的处理过程,都不可避免会遇到各种可预知的、不可预知的异常需要处理。每个过程都单独处理异常,系统的代码耦合度高,工作量大且不好统一,维护的工作量也很大。 那么,能不能将所有类型的异常处理从各处理过程解耦出来,这样既保证了相关处理过程的功能较单一,也实现了异常信息的统一处理和维护?答案是肯定的。下面将介绍使用Spring MVC统一处理异常的解决和实现过程

  • 使用Spring MVC提供的SimpleMappingExceptionResolver
  • 实现Spring的异常处理接口HandlerExceptionResolver 自定义自己的异常处理器
  • 使用@ExceptionHandler注解实现异常处理

(一) SimpleMappingExceptionResolver

使用这种方式具有集成简单、有良好的扩展性、对已有代码没有入侵性等优点,但该方法仅能获取到异常信息,若在出现异常时,对需要获取除异常以外的数据的情况不适用。

@Configuration
@EnableWebMvc
@ComponentScan(basePackages = {"com.balbala.mvc.web"})
public class WebMVCConfig extends WebMvcConfigurerAdapter{
 @Bean
  public SimpleMappingExceptionResolver simpleMappingExceptionResolver()
  {
    SimpleMappingExceptionResolver b = new SimpleMappingExceptionResolver();
    Properties mappings = new Properties();
    mappings.put("org.springframework.web.servlet.PageNotFound", "page-404");
    mappings.put("org.springframework.dao.DataAccessException", "data-access");
    mappings.put("org.springframework.transaction.TransactionException", "transaction-Failure");
    b.setExceptionMappings(mappings);
    return b;
  }
}

(二) HandlerExceptionResolver

相比第一种来说,HandlerExceptionResolver能准确显示定义的异常处理页面,达到了统一异常处理的目标

1.定义一个类实现HandlerExceptionResolver接口,这次贴一个自己以前的代码

package com.athena.common.handler;
import com.athena.common.constants.ResponseCode;
import com.athena.common.exception.AthenaException;
import com.athena.common.http.RspMsg;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;
/** 
 * Created by sam on 15/4/14. 
 */
public class GlobalHandlerExceptionResolver implements HandlerExceptionResolver {  
 private static final Logger LOG = LoggerFactory.getLogger(GlobalHandlerExceptionResolver.class);         
  /**   
  * 在这里处理所有得异常信息   
  */  
  @Override  
  public ModelAndView resolveException(HttpServletRequest req,                     HttpServletResponse resp, Object o, Exception ex) {  
    ex.printStackTrace();   
    if (ex instanceof AthenaException) {  
      //AthenaException为一个自定义异常
      ex.printStackTrace();     
      printWrite(ex.toString(), resp);   
      return new ModelAndView(); 
    }  
    //RspMsg为一个自定义处理异常信息的类 
    //ResponseCode为一个自定义错误码的接口
    RspMsg unknownException = null;   
    if (ex instanceof NullPointerException) {    
      unknownException = new RspMsg(ResponseCode.CODE_UNKNOWN, "业务判空异常", null);
    } else {     
      unknownException = new RspMsg(ResponseCode.CODE_UNKNOWN, ex.getMessage(), null);    }   
      printWrite(unknownException.toString(), resp);  
      return new ModelAndView();  
  } 

  /**   
  * 将错误信息添加到response中   
  *   
  * @param msg   
  * @param response   
  * @throws IOException   
  */  
  public static void printWrite(String msg, HttpServletResponse response) {   
     try {      
       PrintWriter pw = response.getWriter();    
       pw.write(msg);    
       pw.flush();    
       pw.close();   
     } catch (Exception e) {     
       e.printStackTrace();   
     }  
  }
}

2.加入spring的配置中,这里只贴出了相关部分

import com.athena.common.handler.GlobalHandlerExceptionResolver;
import org.springframework.context.annotation.Bean;
import com.athena.common.handler.GlobalHandlerExceptionResolver;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;
/** 
 * Created by sam on 15/4/14. 
 */
public class WebSpringMvcConfig extends WebMvcConfigurerAdapter {

  @Bean
  public GlobalHandlerExceptionResolver globalHandlerExceptionResolver() {
   return new GlobalHandlerExceptionResolver();
  }
}

(三)@ExceptionHandler

这是笔者现在项目的使用方式,这里也仅贴出了相关部分

1.首先定义一个父类,实现一些基础的方法

package com.balabala.poet.base.spring;
import com.google.common.base.Throwables;
import com.raiyee.poet.base.exception.MessageException;
import com.raiyee.poet.base.utils.Ajax;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.core.annotation.AnnotationUtils;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.Date;

public class BaseGlobalExceptionHandler {  
   protected static final Logger logger = null;  
   protected static final String DEFAULT_ERROR_MESSAGE = "系统忙,请稍后再试"; 

   protected ModelAndView handleError(HttpServletRequest req, HttpServletResponse rsp, Exception e, String viewName, HttpStatus status) throws Exception {  
     if (AnnotationUtils.findAnnotation(e.getClass(), ResponseStatus.class) != null)    
     throw e;   
     String errorMsg = e instanceof MessageException ? e.getMessage() : DEFAULT_ERROR_MESSAGE;    
     String errorStack = Throwables.getStackTraceAsString(e);  

     getLogger().error("Request: {} raised {}", req.getRequestURI(), errorStack);    
     if (Ajax.isAjax(req)) {    
       return handleAjaxError(rsp, errorMsg, status);  
     }    
     return handleViewError(req.getRequestURL().toString(), errorStack, errorMsg, viewName); 
   }  

   protected ModelAndView handleViewError(String url, String errorStack, String errorMessage, String viewName) {    
     ModelAndView mav = new ModelAndView();    
     mav.addObject("exception", errorStack);    
     mav.addObject("url", url);   
     mav.addObject("message", errorMessage); 
     mav.addObject("timestamp", new Date());    
     mav.setViewName(viewName);  
     return mav;  
    }  

   protected ModelAndView handleAjaxError(HttpServletResponse rsp, String errorMessage, HttpStatus status) throws IOException {    
      rsp.setCharacterEncoding("UTF-8");    
      rsp.setStatus(status.value());   
      PrintWriter writer = rsp.getWriter();
      writer.write(errorMessage);    
      writer.flush();    
      return null;  
   }  

   public Logger getLogger() {    
      return LoggerFactory.getLogger(BaseGlobalExceptionHandler.class);
   } 
}

2.针对你需要捕捉的异常实现相对应的处理方式

package com.balabala.poet.base.spring;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.NoHandlerFoundException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@ControllerAdvice
public class GlobalExceptionHandler extends BaseGlobalExceptionHandler {  

   //比如404的异常就会被这个方法捕获
   @ExceptionHandler(NoHandlerFoundException.class)  
   @ResponseStatus(HttpStatus.NOT_FOUND)  
    public ModelAndView handle404Error(HttpServletRequest req, HttpServletResponse rsp, Exception e) throws Exception {  
       return handleError(req, rsp, e, "error-front", HttpStatus.NOT_FOUND);  
    }  

   //500的异常会被这个方法捕获
   @ExceptionHandler(Exception.class)   
   @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR) 
   public ModelAndView handleError(HttpServletRequest req, HttpServletResponse rsp, Exception e) throws Exception { 
       return handleError(req, rsp, e, "error-front", HttpStatus.INTERNAL_SERVER_ERROR); 
   }  

   //TODO 你也可以再写一个方法来捕获你的自定义异常
   //TRY NOW!!!

   @Override  
   public Logger getLogger() {   
      return LoggerFactory.getLogger(GlobalExceptionHandler.class);  
   }

 }

以上就三种处理方式,希望对大家的学习有所帮助,也希望大家多多支持。


# spring全局异常处理  # spring  # 全局异常  # spring4  # 全局异常处理  # 详解SpringBoot如何统一后端返回格式  # 如何使用spring ResponseEntity处理http响应  # Spring中的@ResponseStatus使用  # 自定义  # 贴出  # 自己的  # 这是  # 就会  # 在这里  # 已有  # 达到了  # 三种  # 不可避免  # 能将  # 量大  # 能不  # 错误信息  # 你也可以  # 方法来  # 仅能  # 有得  # 第一种  # 相对应 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: Firefox Developer Edition开发者版本入口  HTML5空格和margin有啥区别_空格与外边距的使用场景【说明】  C++用Dijkstra(迪杰斯特拉)算法求最短路径  软银砸40亿美元收购DigitalBridge 强化AI资料中心布局  Laravel如何处理CORS跨域请求?(配置示例)  Windows10如何删除恢复分区_Win10 Diskpart命令强制删除分区  如何在阿里云香港服务器快速搭建网站?  1688铺货到淘宝怎么操作 1688一键铺货到自己店铺详细步骤  php中::能调用final静态方法吗_final修饰静态方法调用规则【解答】  如何在万网开始建站?分步指南解析  Laravel如何实现用户密码重置功能?(完整流程代码)  如何获取PHP WAP自助建站系统源码?  Thinkphp 中 distinct 的用法解析  百度浏览器网页无法复制文字怎么办 百度浏览器复制修复  如何实现建站之星域名转发设置?  千库网官网入口推荐 千库网设计创意平台入口  青岛网站建设如何选择本地服务器?  phpredis提高消息队列的实时性方法(推荐)  Laravel如何处理CORS跨域问题_Laravel项目CORS配置与解决方案  装修招标网站设计制作流程,装修招标流程?  Laravel怎么实现软删除SoftDeletes_Laravel模型回收站功能与数据恢复【步骤】  javascript和jQuery中的AJAX技术详解【包含AJAX各种跨域技术】  ,怎么在广州志愿者网站注册?  Laravel如何使用Gate和Policy进行授权?(权限控制)  韩国服务器如何优化跨境访问实现高效连接?  html如何与html链接_实现多个HTML页面互相链接【互相】  打开php文件提示内存不足_怎么调整php内存限制【解决方案】  详解MySQL数据库的安装与密码配置  如何在 Go 中优雅地映射具有动态字段的 JSON 对象到结构体  Laravel中间件起什么作用_Laravel Middleware请求生命周期与自定义详解  微信小程序 五星评分(包括半颗星评分)实例代码  利用JavaScript实现拖拽改变元素大小  如何快速建站并高效导出源代码?  如何用免费手机建站系统零基础打造专业网站?  如何快速生成专业多端适配建站电话?  javascript中对象的定义、使用以及对象和原型链操作小结  如何用JavaScript实现文本编辑器_光标和选区怎么处理  Laravel Artisan命令怎么自定义_创建自己的Laravel命令行工具完全指南  Laravel如何实现多级无限分类_Laravel递归模型关联与树状数据输出【方法】  Windows家庭版如何开启组策略(gpedit.msc)?(安装方法)  魔方云NAT建站如何实现端口转发?  Laravel如何设置定时任务(Cron Job)_Laravel调度器与任务计划配置  深圳网站制作培训,深圳哪些招聘网站比较好?  Laravel如何配置中间件Middleware_Laravel自定义中间件拦截请求与权限校验【步骤】  原生JS实现图片轮播切换效果  Laravel如何从数据库删除数据_Laravel destroy和delete方法区别  JavaScript中的标签模板是什么_它如何扩展字符串功能  关于BootStrap modal 在IOS9中不能弹出的解决方法(IOS 9 bootstrap modal ios 9 noticework)  如何在万网主机上快速搭建网站?  怎么用AI帮你为初创公司进行市场定位分析?