从 01 开始 从 01 开始
首页
  • 📚 计算机基础

    • 计算机简史
    • 数字电路
    • 计算机组成原理
    • 操作系统
    • Linux
    • 计算机网络
    • 数据库
    • 编程工具
    • 装机
  • 🎨 前端

    • Node
  • JavaSE
  • Java 高级
  • JavaEE

    • 构建、依赖管理
    • Ant
    • Maven
    • 日志框架
    • Junit
    • JDBC
    • XML-JSON
  • JavaWeb

    • 服务器软件
    • 环境管理和配置管理-科普篇
    • Servlet
  • Spring

    • Spring基础
  • 主流框架

    • Redis
    • Mybatis
    • Lucene
    • Elasticsearch
    • RabbitMQ
    • MyCat
    • Lombok
  • SpringMVC

    • SpringMVC 基础
  • SpringBoot

    • SpringBoot 基础
  • Windows 使用技巧
  • 手机
  • 最全面的输入法教程
  • 最全面的浏览器教程
  • Office
  • 图片类工具
  • 效率类工具
  • RSS
  • 码字工具
  • 各大平台
  • 校招
  • 五险一金等
  • 职场规划
  • 关于离职
  • 杂谈
  • 📖 读书

    • 读书工具
    • 读书笔记
  • 🌍 英语

    • 从零开始学英语
    • 英语兔的相关视频
    • Larry 想做技术大佬的相关视频
  • 🏛️ 政治

    • 反腐
    • GFW
    • 404 内容
    • 审查与自我审查
    • 互联网
    • 战争
  • 💰 经济

    • 关于税
    • 理财
  • 💪 健身

    • 睡眠
    • 皮肤
    • 口腔健康
    • 学会呼吸
    • 健身日志
  • 🏠 其他

    • 驾驶技能
    • 租房与买房
    • 厨艺
  • 电影

    • 电影推荐
  • 电视剧
  • 漫画

    • 漫画软件
    • 漫画推荐
  • 游戏

    • Steam
    • 三国杀
    • 求生之路
  • 小说
  • 关于本站
  • 关于博主
  • 打赏
  • 网站动态
  • 友人帐
  • 从零开始搭建博客
  • 搭建邮件服务器
  • 本站分享
  • 🌈 生活

    • 2022
    • 2023
    • 2024
    • 2025
  • 📇 文章索引

    • 文章分类
    • 文章归档

晓林

程序猿,自由职业者,博主,英语爱好者,健身达人
首页
  • 📚 计算机基础

    • 计算机简史
    • 数字电路
    • 计算机组成原理
    • 操作系统
    • Linux
    • 计算机网络
    • 数据库
    • 编程工具
    • 装机
  • 🎨 前端

    • Node
  • JavaSE
  • Java 高级
  • JavaEE

    • 构建、依赖管理
    • Ant
    • Maven
    • 日志框架
    • Junit
    • JDBC
    • XML-JSON
  • JavaWeb

    • 服务器软件
    • 环境管理和配置管理-科普篇
    • Servlet
  • Spring

    • Spring基础
  • 主流框架

    • Redis
    • Mybatis
    • Lucene
    • Elasticsearch
    • RabbitMQ
    • MyCat
    • Lombok
  • SpringMVC

    • SpringMVC 基础
  • SpringBoot

    • SpringBoot 基础
  • Windows 使用技巧
  • 手机
  • 最全面的输入法教程
  • 最全面的浏览器教程
  • Office
  • 图片类工具
  • 效率类工具
  • RSS
  • 码字工具
  • 各大平台
  • 校招
  • 五险一金等
  • 职场规划
  • 关于离职
  • 杂谈
  • 📖 读书

    • 读书工具
    • 读书笔记
  • 🌍 英语

    • 从零开始学英语
    • 英语兔的相关视频
    • Larry 想做技术大佬的相关视频
  • 🏛️ 政治

    • 反腐
    • GFW
    • 404 内容
    • 审查与自我审查
    • 互联网
    • 战争
  • 💰 经济

    • 关于税
    • 理财
  • 💪 健身

    • 睡眠
    • 皮肤
    • 口腔健康
    • 学会呼吸
    • 健身日志
  • 🏠 其他

    • 驾驶技能
    • 租房与买房
    • 厨艺
  • 电影

    • 电影推荐
  • 电视剧
  • 漫画

    • 漫画软件
    • 漫画推荐
  • 游戏

    • Steam
    • 三国杀
    • 求生之路
  • 小说
  • 关于本站
  • 关于博主
  • 打赏
  • 网站动态
  • 友人帐
  • 从零开始搭建博客
  • 搭建邮件服务器
  • 本站分享
  • 🌈 生活

    • 2022
    • 2023
    • 2024
    • 2025
  • 📇 文章索引

    • 文章分类
    • 文章归档
  • JavaSE

  • JavaSenior

  • JavaEE

  • JavaWeb

  • Spring

  • 主流框架

  • SpringMVC

  • SpringBoot

    • SpringBoot教程-尚硅谷

      • SpringBoot 课程介绍
      • Spring 和 SpringBoot
      • HelloWorld
      • 了解自动配置原理
      • 底层注解-@Configuration 详解
      • 底层注解-@Import 导入组件
      • 底层注解-@Conditional 条件装配
      • 原生配置文件引入-@ImportResource
      • 底层注解-配置绑定 @ConfigurationProperties
      • 自动配置原理
      • 自动配置流程
      • Lombok 简化开发
      • DevTools
      • Spring-Initailizr
      • 配置文件-Yaml 用法
      • Web 开发简介
      • web 开发-静态资源规则于定制化
      • 静态资源配置原理
      • Rest 映射及源码解析
      • 请求映射原理
      • 常用参数注解使用
      • MatrixVariable:矩阵变量
      • 各种类型参数解析原理
      • Servlet-API 参数解析原理
      • Model、Map 参数解析原理
      • 自定义对象参数绑定原理
      • 自定义 Converter 原理
      • 数据响应原理
      • 内容协商原理
      • 基于请求参数的内容原理
      • 自定义 MessageConverter 原理
      • Thymeleaf 初体验
      • web 实验-后台管理系统
      • web 实验-抽取公共页面
      • web 实验-遍历数据
      • 源码分析-视图解析器与视图
      • 拦截器-登录检查与静态资源放行
      • 拦截器的执行时机和原理
      • 单文件和多文件上传的使用
      • 文件上传原理
      • 错误处理机制
      • 错误处理-底层组件源码分析
      • 异常处理流程
      • 几种异常处理原理
        • 概述
        • @ControllerAdvice + @ExceptionHandler
        • @ResponseStatus + 自定义异常
        • Spring 底层的异常
        • 自定义 HandlerExceptionResolver
      • Web 原生对象注入
      • 嵌入式 Servlet 容器
      • 定制化原理
      • 数据库场景的自动配置分析和整合测试
      • 自定义方式整合 Druid
      • 通过 starter 整合 Druid
      • 整合 Mybatis
      • 使用注解整合 Mybatis
      • 整合 MybatisPlus 操作数据库
      • MybatisPlus-列表分页展示
      • 整合 Redis
      • 单元测试-Junit5
      • 单元测试-断言机制
      • 单元测试-前置条件
      • 单元测试-嵌套测试
      • 单元测试-参数化测试
      • 指标监控-基本概念
      • 指标监控-配置 EndPoint
      • 指标监控-可视化
      • 原理解析-Profile 功能
      • 配置文件深入
      • 自定义 Starter
      • SpringApplication 初始化过程
      • SpringBoot 完整启动过程
  • Java
  • SpringBoot
  • SpringBoot教程-尚硅谷
2023-08-22
目录

几种异常处理原理

# 440.几种异常处理原理

接下来讲讲如何定制 错误处理逻辑

# 概述

有如下几种处理逻辑:

  • 自定义错误页:例如 error/404.html error/5xx.html;有精确的错误状态码页面就匹配精确,没有就找 4xx.html;如果都没有就使用 SpringBoot 默认的错误页面。
  • @ControllerAdvice+@ExceptionHandler 处理全局异常;底层是 ExceptionHandlerExceptionResolver 支持的,也推荐使用这种方式。
  • @ResponseStatus+自定义异常 ;底层是 ResponseStatusExceptionResolver 支持的,把 responsestatus 注解的信息底层调用 response.sendError(statusCode, resolvedReason);tomcat 发送的/error
  • Spring 底层的异常,如参数类型转换异常;由 DefaultHandlerExceptionResolver 处理框架底层的异常
  • ErrorViewResolver :一般不会自定义,这里不表

# @ControllerAdvice + @ExceptionHandler

根据 ControllerAdvice 的源码可知,它也是一个 @Component,最后也会放到容器中:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
public @interface ControllerAdvice {
1
2
3
4
5

我们新建一个类,加上 @ControllerAdvice 注解:此时该类就可以处理整个 web 中,controller 的异常了。

package com.peterjxl.learnspringbootwebadmin.exception;
import org.springframework.web.bind.annotation.ControllerAdvice;

@ControllerAdvice
public class GlobalExceptionHandler {
  
}
1
2
3
4
5
6
7

‍ 由于我们自定义的方法中,可能有很多方法都会抛出异常,我们可以写一个方法,统一处理这些异常:

package com.peterjxl.learnspringbootwebadmin.exception;

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;

@ControllerAdvice
@Slf4j
public class GlobalExceptionHandler {

    @ExceptionHandler({ArithmeticException.class, NullPointerException.class})
    public String handlerArithmeticException(Exception e) {
        log.error("异常是:{}", e);
        return "login";
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

@ExceptionHandler 表明该方法是一个异常处理器,里面的值表明其能处理什么异常。最后返回一个字符串;根据之前的源码分析可知,返回的都是一个 ModelAndView 对象,因此我们返回的字符串是视图的地址,最后也会转为该类型的对象。

也可以直接返回 ModelAndView 对象,只需设置好数据和 View 即可,参考 SpringMVC 教程的 相关部分 (opens new window) ‍ 接下来重启,访问相关页面,就会跳转到登录页。 ‍ 现在我们通过 debug 的方式,来分析。

步骤和之前类似,首先是执行目标方法,然后发生了异常,因此会将异常赋值给 dispatchException,然后调用 processDispatchResult 方法,

步入 processDispatchResult,可以看到其会调用 processHandlerException 方法,得到 ModelAndView 对象:

‍

因此我们步入 processHandlerException 方法,循环遍历 HandlerExceptionResolver:

在 HandlerExceptionResolver 中,ExceptionHandlerExceptionResolver(如下图)就包含了所有用@ExceptionHandler 注解的方法:

‍

因此,最后会调用我们自己写的 ExceptionHandler,得到 login,并包装为 ModelAndView。

# @ResponseStatus + 自定义异常

有时候我们会自定义异常,那么就可以结合 @ResponseStatus 注解。

例如,我们在校验一个参数(比如用户数量),如果太多就抛出异常; ‍ 首先,我们自定义一个异常

package com.peterjxl.learnspringbootwebadmin.exception;

import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ResponseStatus;

@ResponseStatus(value = HttpStatus.FORBIDDEN, reason = "用户数量太多")
public class UserTooManyException extends RuntimeException {

    public UserTooManyException() {
    }

    public UserTooManyException(String message) {
        super(message);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

然后我们抛出一个异常:

@GetMapping("/dynamic_table")
public String dynamic_table(Model model){
    List<User> users = Arrays.asList(new User("zhangsan", "123456"),
            new User("lisi", "123444"),
            new User("haha", "aaaaa"),
            new User("hehe", "aaddd"));
    model.addAttribute("users", users);

    if (users.size() > 3){
        throw new UserTooManyException();
    }

    return "table/dynamic_table";
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

‍ 重启,访问 localhost: 9999/dynamic_table (opens new window):

接下来我们以 debug 方式启动,来看其原理。我们直接来到 resolveException 方法,ResponseStatusExceptionResolver 就是能处理我们自定义的异常:

‍

我们步入 resolveException:

‍ 在步入 doResolveException:会通过注解工具类,获取注解信息,是否包含了 ResponseStatus,然后调用 resolveResponseStatus 方法,获取状态码和错误信息:

‍

resolveResponseStatus 源码:

protected ModelAndView resolveResponseStatus(ResponseStatus responseStatus, HttpServletRequest request, HttpServletResponse response, @Nullable Object handler, Exception ex) throws Exception {

	int statusCode = responseStatus.code().value();
	String reason = responseStatus.reason();
	return applyStatusAndReason(statusCode, reason, response);
}
1
2
3
4
5
6

‍ 在最后一行的 applyStatusAndReason 方法中,还有直接调用 response.sendError 方法,直接跳转到一个错误页(会发送一个 /error 的请求):

protected ModelAndView applyStatusAndReason(int statusCode, @Nullable String reason, HttpServletResponse response) throws IOException {

	if (!StringUtils.hasLength(reason)) {
		response.sendError(statusCode);
	}
	else {
		String resolvedReason = (this.messageSource != null ? this.messageSource.getMessage(reason, null, reason, LocaleContextHolder.getLocale()) :  reason);
		response.sendError(statusCode, resolvedReason);
	}
	return new ModelAndView();
}
1
2
3
4
5
6
7
8
9
10
11

‍ 注意,此时请求就相当于直接结束了,没有封装 ModelAndView 对象。

# Spring 底层的异常

‍ 比如,我们需要前端传一个 a 的参数:

@GetMapping("/basic_table")
public String basic_table(@RequestParam("a") int a){
    int i = 10 / 0;
    return "table/basic_table";
}
1
2
3
4
5

‍ 但是,前端没有传,此时就会报错:

此时发生的异常就是 Spring 自带的异常了,MissingServletRequestParameterException:

‍

我们既没有定义 ExceptionHandler 来处理该异常,也没有定义 ResponseStatus 来处理该异常,那么默认就由

DefaultHandlerExceptionResolver 来处理; ‍ 我们步入其 doResolveException 方法:

‍

它里面就是一堆 if 分支,判断该异常是什么类型的,然后设置相应的错误信息:

‍

其中就有我们的 MissingServletRequestParameterException:

else if (ex instanceof MissingServletRequestParameterException) {
	return handleMissingServletRequestParameter(
		(MissingServletRequestParameterException) ex, request, response, handler);
}
1
2
3
4

‍ 然后我们步入进 handleMissingServletRequestParameter:可以看到其底层还是 response.sendError:

protected ModelAndView handleMissingServletRequestParameter(MissingServletRequestParameterException ex, HttpServletRequest request, HttpServletResponse response, @Nullable Object handler) throws IOException {
	response.sendError(HttpServletResponse.SC_BAD_REQUEST, ex.getMessage());
	return new ModelAndView();
}
1
2
3
4

‍ 至此,我们对 Spring 的异常解析器都做了一个简单的介绍。

‍

其实这 3 个异常解析器,都实现了 HandlerExceptionResolver 接口,因此我们也可以自定义一个。 ‍

# 自定义 HandlerExceptionResolver

我们可以自定义一个异常解析器:

package com.peterjxl.learnspringbootwebadmin.exception;

import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@Component
public class CustomerHandlerExceptionResolver implements HandlerExceptionResolver {
    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        try{
            response.sendError(511, "我喜欢的错误");
        }catch (Exception e){
            e.printStackTrace();
        }
        return new ModelAndView();
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

‍ 注意,即使我们定义了一个 HandlerExceptionResolver,但是由于默认的 DefaultHandlerExceptionResolver 也能处理,并且其排序是比较靠前的:

‍

所以 for 循环遍历到该处理器就回 break,结束循环。因此我们定义的异常解析器不会生效;想要修改其排序,可以加个 @Order 注解:

package com.peterjxl.learnspringbootwebadmin.exception;

import org.springframework.core.Ordered;
import org.springframework.core.annotation.Order;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.ModelAndView;

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

@Order(Ordered.HIGHEST_PRECEDENCE)
@Component
public class CustomerHandlerExceptionResolver implements HandlerExceptionResolver {
    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        try{
            response.sendError(511, "我喜欢的错误");
        
        }catch (Exception e){
            e.printStackTrace();
        }
        return new ModelAndView();
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

@Order 中,里面的值越小,优先级越高。而 Ordered 的源码如下:可以看到就是 Integer 的最小值

public interface Ordered {
    int HIGHEST_PRECEDENCE = Integer.MIN_VALUE;
    int LOWEST_PRECEDENCE = Integer.MAX_VALUE;
    int getOrder();
}
1
2
3
4
5

‍ 修改后,就能执行我们自己的异常解析器了:

上次更新: 2025/5/17 12:26:09
异常处理流程
Web 原生对象注入

← 异常处理流程 Web 原生对象注入→

最近更新
01
吐槽一下《僵尸校园》
05-15
02
2025 年 4 月记
04-30
03
山西大同 “订婚强奸案” 将会给整个社会带来的影响有多严重? - 知乎 转载
04-26
更多文章>
Theme by Vdoing | Copyright © 2022-2025 | 粤 ICP 备 2022067627 号 -1 | 粤公网安备 44011302003646 号 | 点击查看十年之约
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式