spring mvc 异常处理中@RestControllerAdvice 和 @ControllerAdvice 对比详解
@RestControllerAdvice 和 @ControllerAdvice 对比详解
1. 基本概念
注解 | 等效组合 | 核心作用 |
---|---|---|
@ControllerAdvice | @Component + @RequestMapping (隐式) | 定义全局控制器增强类,处理跨控制器的异常、数据绑定或全局响应逻辑。 |
@RestControllerAdvice | @ControllerAdvice + @ResponseBody | 继承 @ControllerAdvice ,并默认将返回值序列化为 HTTP 响应体(如 JSON)。 |
2. 核心区别
对比维度 | @ControllerAdvice | @RestControllerAdvice |
---|---|---|
返回值处理 | 默认返回视图名称(需配合 @ResponseBody 才能序列化) | 直接返回数据对象,自动序列化为响应体(如 JSON) |
适用场景 | 传统 MVC 应用(如返回 HTML 视图或混合响应) | RESTful API(需返回 JSON/XML 格式数据) |
注解组合 | 需手动添加 @ResponseBody 才能返回 JSON | 内置 @ResponseBody ,无需额外声明 |
返回类型示例 | String (视图名称)、ModelAndView | ResponseEntity , Map , 自定义 POJO |
3. 代码示例对比
场景:全局异常处理
@ControllerAdvice 示例(返回视图名称)
@ControllerAdvice
public class GlobalViewExceptionHandler {@ExceptionHandler(IOException.class)public String handleIOException() {return "error/500"; // 返回视图名称(如 Thymeleaf 模板)}
}
@RestControllerAdvice 示例(返回 JSON)
@RestControllerAdvice
public class GlobalApiExceptionHandler {@ExceptionHandler(IOException.class)public ResponseEntity<ErrorDetails> handleIOException() {ErrorDetails error = new ErrorDetails(500, "Internal Server Error", null);return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(error);}
}
4. 关键功能对比
功能 | @ControllerAdvice | @RestControllerAdvice |
---|---|---|
异常处理 | 支持,需手动定义返回类型(视图或 JSON) | 支持,直接返回 JSON 格式错误对象 |
数据绑定 | 可通过 @InitBinder 统一配置绑定规则 | 同样支持 @InitBinder ,但返回值默认序列化 |
全局方法增强 | 可通过 @ModelAttribute 注入公共数据 | 同样支持,但返回数据自动序列化 |
响应体控制 | 需显式使用 @ResponseBody 或 ResponseEntity | 内置 @ResponseBody ,无需额外声明 |
5. 配置与扩展
共同特性
-
包级作用域:通过
basePackages
指定需要增强的控制器包:@ControllerAdvice(basePackages = "com.example.controllers")
-
方法级过滤:通过
annotations
指定仅处理特定注解的控制器:@ControllerAdvice(annotations = RestController.class)
差异点
- 响应体格式:
-
@ControllerAdvice
需显式配置@ResponseBody
或ResponseEntity
才能返回 JSON:@ControllerAdvice public class MixHandler {@ResponseBody // 显式声明返回 JSON@ExceptionHandler(IOException.class)public ErrorDetails handleIOException() { ... } }
-
@RestControllerAdvice
默认支持序列化:@RestControllerAdvice public class ApiHandler {@ExceptionHandler(IOException.class)public ErrorDetails handleIOException() { ... } // 自动序列化为 JSON }
-
6. 典型使用场景
场景 | 推荐注解 | 原因 |
---|---|---|
传统 Web 应用(返回 HTML) | @ControllerAdvice | 需返回视图名称(如 Thymeleaf 模板路径)。 |
RESTful API 异常处理 | @RestControllerAdvice | 直接返回结构化的 JSON 错误信息,无需额外配置 @ResponseBody 。 |
混合场景(需同时处理视图和 JSON) | @ControllerAdvice | 需通过 @ResponseBody 区分返回类型,或使用 ResponseEntity 控制响应格式。 |
7. 总结表格
维度 | @ControllerAdvice | @RestControllerAdvice |
---|---|---|
核心作用 | 全局异常处理、数据绑定、视图增强 | 专为 REST API 设计,返回 JSON 格式响应 |
返回值默认行为 | 返回视图名称或需 @ResponseBody 显式声明 | 直接返回数据对象,自动序列化为响应体 |
适用场景 | 传统 MVC 应用、混合响应场景 | 纯 REST API 开发(如 Spring Boot 微服务) |
注解组合关系 | 独立注解,需手动配置响应格式 | 等效于 @ControllerAdvice + @ResponseBody |
关键总结
- 选择原则:
- REST API:优先使用
@RestControllerAdvice
,简化 JSON 响应处理。 - 传统 MVC:使用
@ControllerAdvice
,灵活控制视图或 JSON 响应(需配合@ResponseBody
)。
- REST API:优先使用
- 注意事项:
@ControllerAdvice
若需返回 JSON,必须显式添加@ResponseBody
或使用ResponseEntity
。@RestControllerAdvice
内置@ResponseBody
,无需额外声明,适合统一 API 响应格式。
- 最佳实践:
- 对于纯 API 项目,用
@RestControllerAdvice
集中处理异常和响应。 - 在混合项目中,通过
basePackages
区分不同场景的增强类。
- 对于纯 API 项目,用
相关文章:
spring mvc 异常处理中@RestControllerAdvice 和 @ControllerAdvice 对比详解
RestControllerAdvice 和 ControllerAdvice 对比详解 1. 基本概念 注解等效组合核心作用ControllerAdviceComponent RequestMapping(隐式)定义全局控制器增强类,处理跨控制器的异常、数据绑定或全局响应逻辑。RestControllerAdviceControll…...
单元测试原则之——不要过度模拟
什么是过度模拟? 过度模拟(over-mocking)是指在单元测试中,模拟了太多依赖项,甚至模拟了本不需要模拟的简单对象或行为。过度模拟会导致: 测试代码变得复杂,难以阅读和维护。测试逻辑偏离了实际业务逻辑,无法验证真实代码的行为。忽略了被测单元与依赖项之间的真实交互…...
云轴科技ZStackCTO王为:AI Infra平台具备解决私有化AI全栈难题能力
4月1-2日,2025中国生成式AI大会在北京举办,该会议已成为国内AI领域最具影响力的产业峰会之一。云轴科技ZStack CTO王为受邀在“大模型”峰会上发表主题为《AI 原生实践:企业实际场景的 AI 赋能与 Infra 实践探索》演讲,并参加《De…...
牛客 小苯的Z串匹配
注意数组元素是0的情况 #include<iostream> using namespace std;int t; const int N2e510;int main() {ios::sync_with_stdio(0);cin.tie(0);cout.tie(0);cin>>t;while(t){long long n;cin>>n;long long a[N];for(int i0; i<n; i) cin>>a[i];stri…...
拜特科技受邀参加跨境电商行业分会,共探资金管理数字化与AI应用新路径
3月12日,由广东省首席信息官协会主办的“跨境电商行业分会——走进绿联科技”活动在深圳绿联科技圆满举行。作为专注于金融科技与资金管理数字化解决方案的领先提供商,拜特科技受邀参加此次会议,与行业精英共同探讨跨境电商企业的资金管理数字…...
贪心算法(17)(java)可被三整除的最大整数和
给你一个整数数组 nums,请你找出并返回能被三整除的元素 最大和。 示例 1: 输入:nums [3,6,5,1,8] 输出:18 解释:选出数字 3, 6, 1 和 8,它们的和是 18(可被 3 整除的最大和)。 …...
架构师面试(二十八):业务建模
问题 今天我们撇开纯技术,聊一下关于【业务建模】的话题。 何为业务建模?即通过易于理解的模型将业务中的关键问题准确表达出来。 业务建模是需求分析环节乃至整个软件生命周期中非常关键的一环,它几乎决定了软件的开发周期和成本。下面关…...
求教:vue中的find()函数的用法this.$set
需求:为了实现联动,当我在选择问题标题之后,后面几列的内容就会自动联动显示 方案一: 选完之后 直接 是this.questionList[index] this.selected; 这样的效果虽然改动了数组,但是页面上没有显示出来实际数组的内容 …...
常见算法模板总结
文章目录 一、二叉树1. DFS2. BFS 二、回溯模板三、记忆化搜索四、动态规划1. 01背包朴素版本滚动数组优化 2. 完全背包朴素版本滚动数组优化 3. 最长递增子序列LIS朴素版本贪心二分优化 4. 最长公共子序列5. 最长回文子串 五、滑动窗口六、二分查找七、单调栈八、单调队列九、…...
生产者消费者模型
目录 一、生产者消费者模型 1. 生产者消费者模型是什么? 2. 为什么使用生产者消费者模型? 3. 生产者消费者模型的特点(321原则) 🌵3种关系 🌵2种角色 🌵1个交易场所 二、基于BlockingQue…...
linux里怎么禁用 其他用户使用sudo添加定时器,例如创建的tomcat用户禁止使用 sudo crontab -u tomcat -e 添加定时器
要禁止 tomcat 用户通过 sudo crontab -u tomcat -e 添加定时任务,需从 sudo 权限控制和 crontab 访问限制两方面入手。以下是具体步骤: 一、核心思路 禁止 tomcat 用户使用 sudo 提权执行 crontab 修改 /etc/sudoers 配置,移除 tomcat 用户…...
函数作为返回值输出
实际上,函数当做返回值输出的应用场景也很多,也更能体现函数式变成的巧妙,让函数继续返回一个可执行的函数,意味着运算过程是可延续的。 判断数据的类型 常见的判断一个数据的类型的函数: 单例模式 下面是一个单例模…...
黑马 SpringAI+DeepSeek 实战:从对话机器人到企业级知识库的大模型开发全攻略
附完整代码 项目案例,3 天吃透大模型应用开发核心技术 需要完整项目学习视频以及源码的私信博主,谢谢~大家一起加油呐!! 01.认识AI和大模型 小结 AI的发展过程 符号主义 机器学习 深度学习——自然语言处理(NLP…...
word表格间隔设置
1.怎么解决word表格间隔达不到我们想要的要求 其实很简单, 我们直接在word表格里面, 全选表格中里面的内容。接着,我们选择自动调整---->根据内容自动调整表格,即可达到我们想要的要求...
Windows批处理脚本,bat 循环数组进入文件夹进行后续操作
文章目录 前言一、脚本功能解析1.2、定义数组1.2、遍历数组1.2、处理每个数组元素1.2、循环控制1.2、结束脚本 二、之前编写的脚本三、优化后的脚本代码四、总结五、感谢 前言 Windows批处理脚本,主要功能是遍历一个预定义的数组,并对每个数组元素执行cd…...
TurtleBot3 Package turtlebot3_drive source code read
前言 此处阅读简单的 turtlebot3_drive 代码。 从ROS的角度,作为一个demo,它足够小、简单,可以从中看见ROS的 NodeHandle如何使用。此外,我们也能简单地看到 “自动避障功能的实现”。 从C的角度,它实际上并不复杂&…...
机器学习的下一个前沿是因果关系吗?
如今,越来越多研究人员意识到,将因果关系融入机器学习,或许会是该领域实现重大突破的关键所在。 机器学习凭借先进的预测能力,已为诸多行业带来了显著变革,但也暴露出了一定的局限性。而因果关系,作为理解…...
Mujoco xml模型
Mujoco xml模型 一个例子compileroptionassetmesh default基本使用childclass与class多个class worldbodybody关系inertialjointgeom XML主要分为以下三个部分: < asset> : 用 tag导入STL文件;< worldbody>:用tag定义…...
MyBatis 详解及代码示例
MyBatis 是一个 半自动 ORM 框架,主要用于 Java 与数据库之间的持久化操作,它本质是对 JDBC 的封装 全名:MyBatis(前身 iBATIS)核心作用:自动将 SQL 执行结果映射为 Java 对象;也可以将 Java 对…...
STL-list链表
STL-list链表实现 STL中采用双向带头循环链表来实现 list,下面将使用 C++ 实现 STL list 链表。 list 类中包含两个主要部分,一个是指向哨兵位头节点的指针(_head),另一个是结构体类型的迭代器(__list_iterator)。 哨兵位头节点本身是不存储数据的,它只是用于简化代码…...
R语言中的rvest库写个视频爬虫通用代码
朋友让我用R语言的rvest库写一个通用的视频爬虫代码示例。首先,我需要回忆一下rvest库的主要功能,它主要是用来做网页抓取和解析的,类似于Python的BeautifulSoup。但是视频爬虫的话,可能需要处理动态加载的内容,或者找…...
SQLite 中日期型数据定义及处理(Delphi 版本)
在使用SQLite的时候,肯定需要使用到日期型数据类型,但是SQLite没有直接支持日期类型,比如在其他数据库中支持的DateTime类型,在Delphi中是TDateTime类型。 那么实际处理中应该如何处理呢? 可以使用两种方式类在SQLit…...
4.9复习记
1.地宫取宝--记忆化搜索,可以先写void dfs,然后在改成ll 形式的,边界条件return 0/1; 记忆化数组与dfs元素保持一致,记得记忆化剪枝 这个题特殊在value可能是0,不取的时候应该记为-1 https://mpbeta.cs…...
Flink基础
Flink基础 目录 Flink简介核心概念编程模型核心功能应用场景部署模式生态系统最佳实践学习资源实践案例高级特性 1. Flink简介 1.1 什么是Flink Apache Flink是一个开源的分布式流处理和批处理系统。它能够处理有界(批处理)和无界(流处理…...
SASE、零信任安全理念的发展脉络
SASE(安全访问服务边缘)与零信任架构的发展脉络,是云安全理念从 “边界防御” 向 “动态信任” 跃迁的典型缩影。两者的演进既独立又交织,共同推动网络安全从静态合规走向主动治理。以下从技术起源、理念突破、产业实践到未来趋势展开深度解析: 一、零信任:从理论构想到…...
CompletableFuture 和 List<CompletableFuture> allOf() join() get() 使用经验
CompletableFuture<Map<Menu, Map<IntentDetail, Double>>> xxx CompletableFuture.supplyAsync(() -> {Map<Menu, Map<IntentDetail, Double>> scores new ConcurrentHashMap<>();// 存储结果scores.computeIfAbsent(menu, k -> n…...
Vue.js组件化开发实战:从工程化到安全纵深设计
文章目录 开篇:现代前端组件化演进之路 组件设计核心:高内聚低耦合实践 工程化基石:从Webpack到Monorepo 安全纵深设计:RASP在组件层的实现 实战:动态表单组件的三次进化 进阶篇:组件工厂模式与策略模…...
【深度解析】SkyWalking 10.2.0版本安全优化与性能提升实战指南
前言 Apache SkyWalking 作为云原生可观测性领域的佼佼者,在微服务架构监控中扮演着至关重要的角色。然而,官方版本在安全性、镜像体积和功能扩展方面仍有优化空间。本文将分享一套完整的 SkyWalking 10.2.0 版本优化方案,从安全漏洞修复到镜…...
NOIP2011提高组.玛雅游戏
目录 题目算法标签: 模拟, 搜索, d f s dfs dfs, 剪枝优化思路*详细注释版代码精简注释版代码 题目 185. 玛雅游戏 算法标签: 模拟, 搜索, d f s dfs dfs, 剪枝优化 思路 可行性剪枝 如果某个颜色的格子数量少于 3 3 3一定无解因为要求字典序最小, 因此当一个格子左边有…...
常微分方程求解全解析:从基础到矩阵方法深度实践
常微分方程求解全解析:从基础到矩阵方法深度实践 一、常微分方程基础与解法体系 1.微分方程基本概念解析 常微分方程的阶数指方程中未知函数导数的最高阶数。通解是包含任意常数且常数个数与方程阶数相同的解,特解则是通解中任意常数取特定值得到的解。以自由落体运动为例…...
Go 微服务框架 | 中间件
文章目录 定义中间件前置中间件后置中间件路由级别中间件 定义中间件 中间件的作用是给应用添加一些额外的功能,但是不会影响原有应用的编码方式,想用的时候直接添加,不想用的时候也可以轻松去除,实现所谓的可插拔。中间件的实现…...
【HarmonyOS Next之旅】DevEco Studio使用指南(十二)
目录 1 -> Code Linter代码检查 2 -> 配置代码检查规则 3 -> 查看/处理代码检查结果 1 -> Code Linter代码检查 Code Linter针对ArkTS/TS代码进行最佳实践/编程规范方面的检查。 可根据扫描结果中告警提示手工修复代码缺陷,或者执行一键式自动修复…...
Java设计模式之桥接模式:从入门到架构级实践
1. 什么是桥接模式? 桥接模式(Bridge Pattern) 是一种结构型设计模式,其核心目标是将抽象部分与实现部分分离,使它们能够独立变化。通过这种方式,桥接模式解决了多层继承带来的复杂性,并增强了…...
Jupyter Lab 无法启动 Kernel 问题排查与解决总结
📄 Jupyter Lab 无法启动 Kernel 问题排查与解决总结 一、问题概述 🚨 现象描述: 用户通过浏览器访问远程服务器的 Jupyter Lab 页面(http://xx.xx.xx.xx:8891/lab)后,.ipynb 文件可以打开,但无…...
【LeetCode 热题100】73:矩阵置零(详细解析)(Go语言版)
🚀 力扣热题 73:矩阵置零(详解 多种解法) 📌 题目描述 给定一个 m x n 的整数矩阵 matrix,如果一个元素为 0,则将其所在行和列的所有元素都设为 0。请你 原地 使用常量空间解决。 Ἲ…...
OminiAdapt:学习跨任务不变性,实现稳健且环境-觉察的机器人操作
25年3月来自中科大、北理工和中科院自动化所的论文“OminiAdapt: Learning Cross-Task Invariance for Robust and Environment-Aware Robotic Manipulation”。 随着具身智能的快速发展,利用大规模人体数据对人形机器人进行高水平的模仿学习,成为学术界…...
Vue3中父组件将一个ref定义的对象类型传递给子组件的解包机制
在Vue3中,当父组件将一个ref定义的对象类型传递给子组件时,子组件接收到的不是原始的Ref类型,而是该ref的.value值,即被解包后的响应式对象。具体行为如下: 关键点解析: 自动解包机制: Vue3在模…...
批量将 SVG 转换为 jpg/png/Word/PDF/ppt 等其它格式
SVG(可缩放矢量图形)是一种广泛使用的图像格式,因其矢量特性在不同分辨率下都能保持清晰,但在某些情况下,用户可能需要将 SVG 格式的图片转换为更常见的位图格式,如 JPG、PNG 等,以适应不同平台…...
微服务篇——SpringCloud
服务注册 Spring Cloud5大组件有哪些? 服务注册和发现是什么意思?Spring Cloud如何实现服务注册发现? nacos与eureka的区别 负载均衡 如何实现负载均衡? Ribbon负载均衡的策略有哪些? 如何自定义负载均衡的策略&…...
Windows 11 家庭中文版 安装docker desktop 无法开启自启动问题处理
前言 我在某台Windows 11家庭中文版的电脑上安装Docker Desktop后,老是无法开机启动,已经按照Docker Desktop 设置调整的方式设置了开机启动,但是重启后发现还是无法自启动,需要手动点击启动。然后使用任务计划程序新建一个开机启…...
蓝桥杯备考
先浅学一遍数据结构,不会拉倒,找点简单题练练语法基础 然后边学边刷二分查找和双指针 递归和暴力,边学边刷 学习贪心,练个几十道 再去过下数据结构 开始算法:搜索,动态规划, 搜索很重要,深…...
Elasticsearch 系列专题 - 第一篇:Elasticsearch 入门
Elasticsearch 是一个功能强大的开源分布式搜索和分析引擎,广泛应用于日志分析、实时搜索、数据可视化等领域。本篇将带你了解 Elasticsearch 的基本概念、安装方法以及简单操作,帮助你快速上手。 1. 什么是 Elasticsearch? 1.1 Elasticsearch 的定义与核心概念 Elasticse…...
【LeetCode 题解】数据库:1321.餐馆营业额变化增长
一、问题描述 本题给定了一个名为 Customer 的表,记录了餐馆顾客的交易数据,包括顾客 ID、姓名、访问日期和消费金额。作为餐馆老板,我们的任务是分析营业额的变化增长情况,具体来说,就是计算以 7 天(某日…...
Apache Nifi安装与尝试
Apache NIFI中文文档 地址:https://nifichina.github.io/ 下载安装配置 1、环境准备 Nifi的运行需要依赖于java环境,所以本机上需要安装java环境,并配置环境变量。 1.1查看本机是否已经存在java环境 请先执行以下命令找出系统中真实可用…...
【Git 常用操作指令指南】
一、初始化与配置 1. 设置全局账户信息 git config --global user.name "用户名" # 设置全局用户名 git config --global user.email "邮箱" # 设置全局邮箱 --global 表示全局生效,若需针对单个仓库配置,可省略该参数 2.…...
Django 生成PDF文件
在这里,我们将学习如何使用Django视图设计和生成PDF文件。我们将使用ReportLab Python PDF库生成PDF,该库可以创建定制的动态PDF文件。 这是一个开源库,可以通过在Ubuntu中使用以下命令轻松下载。 $ pip install reportlab Python Copy …...
多账户使用Github的场景,设置 SSH 多账号使用特定 key
遇到多账户使用Github的场景,常难以管理ssh文件 解决方案: 你可以通过配置 ~/.ssh/config 文件,生成多个SSH key 让 Git 识别不同 key 来对应不同 GitHub 账号。 ✅ 正确的 key 类型有这些常见选项: rsa:老牌算法&a…...
js中this指向问题
在js中,this关键字的指向是一个比较重要的概念,它的值取决于函数的调用方式。 全局状态下 //全局状态下 this指向windowsconsole.log("this", this);console.log("thiswindows", this window); 在函数中 // 在函数中 this指向win…...
BabelDOC ,开源的 AI PDF 翻译工具
BabelDOC 是一款开源智能 PDF 翻译工具,专门为科学论文的翻译而设计。它能够在原文旁边生成翻译文本,实现双语对照,用户无需频繁切换窗口,极大提升了阅读的便利性。此外,BabelDOC 能够完整保留数学公式、表格和图形&am…...
Dify 生成提示词的 Prompt
Dify 生成提示词的 Prompt **第1次提示词****第2次提示词****第3次提示词**总结 Dify 生成提示词是,会和LLM进行3次交互,下面是和LLM进行交互是的Prompt。 以下是每次提示词的概要、目标总结以及原始Prompt: 第1次提示词 概要: …...