SpringMVC全局异常处理

一、异常处理思路

1. 异常抛出流程 Controller 调用 Service，Service 调用 Dao，异常逐级向上抛出 ，最终由 DispatcherServlet（前端控制器） 交给 异常处理器 统一处理。

2. 为什么要统一异常处理？

   • 避免每个方法写 try-catch，代码冗余
   • 统一跳转到友好错误页面，不向用户暴露异常堆栈
   • 便于维护、统一管理错误信息

3. SpringMVC 异常处理核心组件

   • 自定义异常类：封装业务提示信息
   • 异常处理器：实现 HandlerExceptionResolver 接口
   • 配置异常处理器：在 springmvc.xml 中注册
   • 友好错误页面：展示提示信息

二、代码实现（完全按照课堂案例）

1. 控制器：RoleController.java

模拟异常，不使用 try-catch，直接抛出

package cn.tx.demo3;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * 模拟异常
 */
@Controller
@RequestMapping("/role")
public class RoleController {

    /**
     * 使用异常处理器方式
     * @return
     */
    @RequestMapping("/findAll.do")
    public String findAll(){
        System.out.println("执行了...");
        // 模拟异常
        int a = 10/0;
        return "suc";
    }

}

---

2. 自定义异常类：SysException.java

package cn.tx.demo3;

/**
 * 系统的异常类
 */
public class SysException extends Exception{

    // 提示消息
    private String message;

    @Override
    public String getMessage() {
        return message;
    }

    public void setMessage(String message) {
        this.message = message;
    }

    public SysException(String message) {
        this.message = message;
    }
}

---

3. 自定义异常处理器：SysExceptionResolver.java

实现 HandlerExceptionResolver 接口

package cn.tx.demo3;

import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;


public class SysExceptionResolver implements HandlerExceptionResolver {

    /**
     * 程序出现了异常，调用异常处理器中的方法
     * @param o
     * @param e
     * @return
     */
    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object o, Exception e) {
        // 在控制台打印异常的信息
        e.printStackTrace();
        // 做强转
        SysException exception = null;
        // 判断
        if(e instanceof SysException){
            exception = (SysException)e;
        }else{
            exception = new SysException("系统正在维护，请联系管理员");
        }

        // 存入异常提示信息
        ModelAndView mv = new ModelAndView();
        mv.addObject("errorMsg",exception.getMessage());
        // 设置跳转的页面
        mv.setViewName("error");
        return mv;
    }

}

---

4. SpringMVC 配置异常处理器

在 springmvc.xml 中添加：

<!-- 配置异常处理器 -->
<bean id="sysExceptionResolver" class="cn.tx.demo3.SysExceptionResolver" />

---

5. 错误友好页面：error.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %>
<html>
<head>
    <title>错误提示页面</title>
</head>
<body>

<h3>错误的友好提示页面</h3>

${errorMsg}

</body>
</html>

三、执行流程

1. 访问/role/findAll.do
2. 控制器执行10/0 抛出算术异常
3. 异常抛到前端控制器DispatcherServlet
4. 找到异常处理器 SysExceptionResolver
5. 进入resolveException方法
6. 判断异常类型，封装提示信息
7. 跳转到error.jsp，展示友好信息
8. 控制台打印异常堆栈

四、运行效果

页面显示：

错误的友好提示页面
系统正在维护，请联系管理员

控制台打印：

java.lang.ArithmeticException: / by zero

---

五、总结

1. SpringMVC 异常处理采用 AOP 思想，统一拦截处理
2. 接口：HandlerExceptionResolver
3. 两个主要角色：
   • 自定义异常：提供提示信息
   • 异常处理器：统一处理、跳转页面
4. 配置后全局生效，所有 Controller 异常都会被捕获
5. 页面友好、安全、便于维护