SpringMVC全局异常处理

一、异常处理思路

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

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

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

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

二、代码实现(完全按照课堂案例)

1. 控制器:RoleController.java

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

java 复制代码
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

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 接口

java 复制代码
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 中添加:

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

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

java 复制代码
<%@ 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 复制代码
错误的友好提示页面
系统正在维护,请联系管理员

控制台打印:

复制代码
java.lang.ArithmeticException: / by zero

五、总结

  1. SpringMVC 异常处理采用 AOP 思想,统一拦截处理
  2. 接口:HandlerExceptionResolver
  3. 两个主要角色:
    • 自定义异常:提供提示信息
    • 异常处理器:统一处理、跳转页面
  4. 配置后全局生效,所有 Controller 异常都会被捕获
  5. 页面友好、安全、便于维护
相关推荐
用户298698530142 小时前
Word 文档字符级格式化:Java 实现方案详解
java·后端
笨鸟飞不快2 小时前
从单个服务到集群:一次完整的性能排查复盘
java·前端
荣码2 小时前
用Streamlit给AI应用套个界面,10行代码出Web页面
java·python
SamDeepThinking2 小时前
Java微服务练习方式
java·后端·微服务
朦胧之13 小时前
AI 编程-老项目改造篇
java·前端·后端
程序猿大帅17 小时前
别再只当调包侠了:用 Spring AI 落地 Function Calling,我被大模型硬生生砸出了三个大坑
java
程序员晓琪18 小时前
约定大于配置:基于 Java 包名自动生成 API 版本路由的最佳实践
java·spring boot·后端
Flittly18 小时前
【AgentScope Java新手村系列】(11)中断与恢复
java·spring boot·spring
众少成多积小致巨19 小时前
JNI (Java Native Interface) 技术手册中文参考指南
android·java·c++
东坡白菜19 小时前
破局全栈:前端开发的Java入门实战记录—JPA(2)
java·后端