SpringBoot 3.0新特性:ProblemDetail让错误响应不再头疼

Springboot3新特性异常信息ProblemDetail详解 例如,考虑一个响应,该响应表明客户的账户没有足够的权限。此外,Problem Detail信息可以包含其他信息,例如标识问题具体发生的URI(有效地为“Joe上周四没有足够的信用”这一概念提供了标识符),这对于支持或取证目的可能很有用。,以确保这个“properties”映射被展开,并在响应中作为顶级JSON属性呈现,同样,反序列化期间的任何未知属性都会插入到这个Map中。的方便基类,它处理所有Spring MVC异常,以及任何ErrorResponseException,并渲染一个带有主体的错误响应。 阅读详情

01 引言

之前写过一篇关于统一相应的参数处理的文章,有路过的朋友指出错误信息为什么还要统一处理。技术储备浅薄的我一脸懵逼,经过交流才知道,大佬使用了ProblemDetail处理异常,于是专门学习了一下,记录下来分享给大家。

02 简介

org.springframework.http.ProblemDetail

ProblemDetail 是 Spring Boot 3.0(Spring Framework 6.0)引入的类,用于标准化 HTTP API 错误响应格式,符合 RFC 7807 标准。

官网地址:https://docs.spring.io/spring-boot/3.5/reference/web/servlet.html#web.servlet.spring-mvc.error-handling

2.1 属性

private URI type: 错误类型标识(URI格式)

private String title:简短错误描述

private int status:HTTP状态码

private String detail:详细错误描述

private URI instance:具体错误实例标识

private Map<String, Object> properties:扩展属性

2.2 异常返回一览

SpringBoot 3.0之前的报错:

SpringBoot 3.0之后的报错:

03 使用

ProblemDetail的使用是有讲究的,不了解其中的道道,可能触发不了ProblemDetail的异常包装。

3.1 启动开关

SpringBoot框架针对ProblemDetail的启用做了开关,默认关闭。

通过配置生效:

spring.mvc.problemdetails.enabled=true

配置类:

3.2 测试方法

@GetMapping("/divide")
public int divide(int a, int b) {
    return a / b; 
}

如果 b=0,会触发 ArithmeticException。但是这个异常并没有触发ProblemDetail异常的封装。

测试请求:http://127.0.0.1:8080/divide?a=10&b=0

3.3 原因追溯

没有成功,难道是因为配置没有生效。我们从官网找一点蛛丝马迹。

大致意思是:要想启用RFC响应,可以扩展ResponseEntityExceptionHandler并声明@ControllerAdvice。处理器通过@ExceptionHandler采集异常,也可以添加其他异常并映射到ProblemDetail

所以我们看看ResponseEntityExceptionHandler的子类有没有类似的实现:

通过查看,我们可以发现ProblemDetailsExceptionHandler子类,似乎是处理ProblemDetail的关键。

@ControllerAdvice注解我们再熟悉不过了,用于参数绑定、异常处理等。而ResponseEntityExceptionHandler默认处理的异常:

显然没有ArithmeticException异常,自然不会被处理。

那我们只需要使用ResponseEntityExceptionHandler中的异常即可。

3.4 重新测试

测试方法中接收的字段类型为int,我们只需要传入非int类型的数据,就会触发MethodArgumentTypeMismatchException异常。而MethodArgumentTypeMismatchException继承TypeMismatchException异常。

测试地址:http://127.0.0.1:8080/divide?a=10&b=a

结果已经触发ProblemDetail的信息了。

04 问题

ProblemDetail异常包装触发了,但是并不是所有的异常都可以兜得住。即便是ResponseEntityExceptionHandler中的异常也有没有包装的。

小编这里不太理解为什么会从中间分开,上半部分异常不会触发ProblemDetail异常包装,而下半部分会触发。

所以我们在需要处理全局异常的时候,还需要我们自己去处理所有的异常,包括自定义异常已达到统一参数。

05 触发源码

ProblemDetailsExceptionHandler的包位于org.springframework.boot.autoconfigure.web.servlet下,又是如何通过配置启动的呢?

当然还是自动配置的类:WebMvcAutoConfiguration

06 小结

我们可以自己通过ProblemDetail封装异常信息,然后统一异常参数,全局统一处理异常,以达到全局统一的目的。可能里面还有小编理解不到位的地方,有问题评论区指出来,小编加以修正。

动力节点王鹤SpringBoot3笔记——第五章 说说Web服务 需求:我们示例查询某个isbn的图书。在application.yml中配置图书的初始数据。用户访问一个api地址,查询某个isbn的图书, 查询不到抛出自定义异常BootNotFoundException。自定义异常处理器捕获异常。ProblemDetail 作为应答结果。支持RFC 7807创建新的SpringBoot项目Lession17-ProblemDetail,依赖选择Spring Web , lombok。Maven构建工具,JDK19,包名com.bjpowernode。 阅读详情

相关推荐

SpringBoot3实战:ProblemDetail异常处理与RFC 7807规范深度解析

本文深入解析了SpringBoot3中ProblemDetail异常处理机制与RFC 7807规范的实践应用。通过标准化JSON错误响应格式,ProblemDetail显著提升了API异常信息的可读性和调试效率,适用于RESTful API开发中的全局异常处理、参数验证等场景。文章详细介绍了核心结构、实战配置、性能优化及与OpenAPI等技术的整合方案。

weixin_29251567的博客 395

Java SpringBoot的ProblemDetail实现全局异常统一处理让接口不在需要catch/ProblemDetail实现错误处理的标准化

ProblemDetail 是 RFC 7807 定义的一种标准格式,用于在 HTTP API 中表示错误信息。它以 JSON 格式返回错误的详细信息,包括状态码、错误标题、详细描述等。Spring Boot 3.2 提供了对 ProblemDetail 的内置支持,使得我们可以轻松地在应用中实现标准化的错误响应。在实际应用中,我们通常会定义一些自定义异常来表示特定的错误情况。

C_V_Better的博客 756

【动力节点】王鹤SpringBoot3笔记——第五章 说说Web服务

需求:我们示例查询某个isbn的图书。在application.yml中配置图书的初始数据。用户访问一个api地址,查询某个isbn的图书, 查询不到抛出自定义异常BootNotFoundException。自定义异常处理器捕获异常。ProblemDetail 作为应答结果。支持RFC 7807创建新的SpringBoot项目Lession17-ProblemDetail,依赖选择Spring Web , lombok。Maven构建工具,JDK19,包名com.bjpowernode。

qwsrfss的博客 731

重学SpringBoot3-Problemdetails

随着 Spring Boot 3 的发布,Spring Framework 6 继续在提升开发者体验和应用性能方面迈出重要步伐。在众多引人注目的新特性中,对 Problem Details(问题详情)的支持尤为值得关注。这一特性基于 RFC 7807 标准,旨在为 HTTP API 提供一种标准化的错误响应格式。本文将深入探讨 Spring Boot 3 中 Problem Details 的概念、应用及其对微服务架构的潜在影响。

CoderJia的学习之路 1817

【动力节点】王鹤SpringBoot笔记——第五章 说说Web服务

需求:我们示例查询某个isbn的图书。在application.yml中配置图书的初始数据。用户访问一个api地址,查询某个isbn的图书, 查询不到抛出自定义异常BootNotFoundException。自定义异常处理器捕获异常。ProblemDetail 作为应答结果。支持RFC 7807创建新的SpringBoot项目Lession17-ProblemDetail,依赖选择Spring Web , lombok。Maven构建工具,JDK19,包名com.bjpowernode。

Javanewspaper的博客 1270

@Autowired(required=false)注入注意的问题

1、前言在使用spring开发过程中,我们基本上都是使用@Autowired这个注解,用来注入已有的bean。但是有些时候,会注入失败。当我们加上参数(required=false)就能解决。今天整理一个我在实际开发中的例子2、required属性@Autowired(required=true):当使用@Autowired注解的时候,其实默认就是@Autowired(required=true)...

static_coder的博客 12万+

Spring Framework 6.x 异常国际化完全指南:让错误信息“说“多国语言

Spring Framework 6.x引入了全新的异常处理机制,通过ProblemDetail和ErrorResponse接口实现异常国际化。ProblemDetail遵循RFC 7807规范,提供标准化的错误响应格式。ErrorResponse是国际化核心接口,支持通过MessageSource自动处理异常消息的多语言转换。开发者可以自定义异常实现这些接口,利用Spring自动生成的国际化消息code(基于完整类名)或自定义消息code。

千木一枝的博客 1671

Spring Boot 3 新特性:ProblemDetail 异常信息详解

在 Spring Boot 3 中,引入了一个新的特性,即 ProblemDetail 异常信息的处理。在 Spring Boot 3 中,框架内置了对 ProblemDetail 的支持,可以方便地生成和处理异常信息。另外,为了更好地利用 Spring Boot 3 提供的 ProblemDetail 特性,建议在项目中引入相关的依赖,并根据具体业务场景进行配置和使用。在方法内部,首先确定了异常的 HTTP 状态码,然后创建了一个 ProblemDetail 对象,并将异常信息填充到该对象中。

IOWEL的博客 219

RESTful API 命名指南

RESTful API 又叫 Web API, REST 是 representational state transfer 的简写。RESTful API 使用 HTTP 协议的 GET, PUT, POST, PATCH 等操作来定义程序接口。由于这四个操作在 HTTP 协议都有特定的含义,所以我们应该遵循它们的习惯性用法。 GET 用来查询 PUT 来修改资源 POST 用来增加资源或者执行控制命令 PATCH 用来改变资源的某个属性 在实际应用中由于只改变资源某个属性的情形较少,所以很多情况下会直

surfirst的博客 3083

【SpringBoot 3.x 第50节】Spring MVC 6 时代,REST API 错误处理你还在乱七八糟?RFC 7807 Problem Details 来了,你还不赶紧上车?

🏆本文收录于《滚雪球学SpringBoot 3》,专门攻坚指数提升,本年度国内最系统+最专业+最详细(永久更新)。    本专栏致力打造最硬核 SpringBoot3 从零基础到进阶系列学习内容,🚀均为全网独家首发,打造精品专栏,专栏持续更新中…欢迎大家订阅持续学习。 如果想快速定位学习,可以看这篇【SpringBoot3教程导航帖】,你想学习的都被收集在内,快速投入学习!!两不误。    若还想学习更多,可直接前往《滚雪球学SpringBoot(全版本合集)》,涵盖SpringBoot所有版本教学文章

**My Coding Family** 1010

BurpSuite+安卓模拟器双保险:避开真机抓包限制的完整配置指南

本文详细介绍了如何通过BurpSuite与安卓模拟器(如雷电、夜神)协同工作,绕过真机抓包限制的完整配置指南。从环境准备、网络拓扑配置到证书部署和流量分析,提供了一套高效的解决方案,帮助安全测试人员稳定捕获手机数据包,提升测试效率。

Apple的专栏 439

springbootProblemDetail

基于 Http 协议的请求,可通过 Htp Status Code 分析响应结果,200 为成功, 4XX 为客户端错误,500 是服务器程序代码异常。RFC7807中对这些做了规范的定义。Spring Boot 识别ErrorResponse 类型作为异常的应答结果可以直接使用 ErrorResponse 作为异常处理方法的返回值,ErrorResponseException 是 ErrorResponse 的基本实现类。定义了Http 应答错误的处理细节,增强了响应错误的内容。包含标准和非标准的字段。

lixingzhuo的博客 382

vue使用 APlayer+Meting实现音乐播放,支持多平台音乐:网易云、腾讯、虾米、酷狗、百度

  我之前写过一篇博客:使用 APlayer 实现音乐播放器,虽然 APlayer 让我实现了想要的音乐播放器效果,但是音频列表 audio 的音频链接、音频封面、歌词等,是需要自己去补充的。   那么这些数据从哪里来呢?   我昨天有发愁一会儿会儿,也去搜了获取音乐列表的接口,可以发请求去获取数据嘛。   也有瞅见MetingJS,A powerful plugin connect APlayer and Meting,一个连接APlayer和Meting的功能强大的插件,附上GitHub地址:https

小R.的博客 4799

Jackson Mixin 详解

Mixin 是 Jackson 提供的一种机制,允许你在不修改原始类源码的情况下,为其添加或覆盖 Jackson 注解。它通过"混入"的方式,将注解逻辑与实体类定义分离。核心概念分离关注点:序列化规则与领域模型分离无侵入式:不需要修改原始类,适用于第三方库的类运行时绑定:在 ObjectMapper 级别配置,不影响类本身。

若鱼的专栏 619

暴力破解pdf文档密码

相信小伙伴们都遇到这种情况;你收到了一些标题很吸引人的pdf文档 或者是重要数据泄露 学习资料总结,再或者是某机构的押题密卷,打开pdf却提示你要输入密码 因为不知道密码 只能弃罢。我就遇到过这种情况 网友发来了标题为某天一的押题密卷 ,我也想看看这个卷子的题怎么样,因为被设置了密码 我尝试用6到10位的纯数字组合来暴力破解这个pdf,结果三 四个小时都没找到正确的密码。有些网友为破解这个密码 请某宝某多来破解 也都没有破解成功。

shelter1234567的博客 1万+

【交易系统系列27】带你看懂订单的“奇幻漂流”

作为一个在交易所后台“厨房”里摸爬滚打了十多年的老兵,我将用一杯手冲咖啡的时间,带你亲历一次完整的订单“奇幻漂流”。本文将用一个“奶爸”的生活视角,硬核拆解**撮合(Matching)**、**清算(Clearing)**、**结算(Settlement)**和**出入金**这四大核心环节。这不仅是一次对**交易系统优化**和**撮合引擎架构**的深度剖析,更是一场关于传统金融与数字金融两种不同“上菜”哲学的真实故事。

weixin_43988453的博客 407

SpringBoot3 Web开发新特性(Problemdetails、函数式Web)

其中headers的Content-Type是application/problem+json。其中problem可以通过额外的拓展返回一些业务数据。使用函数式的方式,定义Web的请求处理流程。使用的java8函数式接口。以Restful方式,对User进行CRUD。

Bulut0907 424

从标记基因到功能分析:手把手教你人工注释单细胞亚群的完整流程

本文详细介绍了人工注释单细胞亚群的完整流程,从标记基因筛选到功能分析验证,特别针对肿瘤微环境、发育轨迹等复杂场景提供解决方案。通过差异表达分析、多维数据整合和实验验证,帮助研究者准确识别细胞类型,提升单细胞转录组研究的生物学解读深度。

jenkins8butler的博客 245

Springboot3实战:如何用ProblemDetail优雅处理API异常(附完整代码示例)

本文详细介绍了如何在Spring Boot 3中使用ProblemDetail实现标准化的API异常处理,遵循RFC 7807规范。通过实战代码示例,展示了如何构建统一的错误响应格式,提升微服务架构下的系统可靠性和开发者体验,特别适合需要高效处理HTTP响应的开发场景。

weixin_42519781的博客 142

基于YOLOv8/YOLOv7/YOLOv6/YOLOv5的体育赛事目标检测系统(Python+PySide6界面+训练代码)

本文详细介绍了一个基于YOLOv5/v6/v7/v8的体育赛事目标检测系统的设计与实现。系统采用先进的深度学习算法,结合PySide6图形界面,实现了对体育赛事中运动员、球类、裁判等多种目标的实时检测与跟踪。本文将全面阐述系统的架构设计、算法原理、训练流程、界面实现以及实际应用效果,并提供完整的代码实现。

YOLO 510

LVGL misc timer 定时器(lv_timer.c)

定时器机制是LVGL中非常重要的一项功能,它承载了LVGL的延时任务执行,周期任务执行,时序任务执行等,可以说理解定时器的设计就一定程度上理解发LVGL的任务调度机制。

Bigan(安)的博客 4733

微擎小程序返回结果不是有效的json_5min+:美化 API,包装返回结果

摘自句幽 uoyo 的博客句幽 uoyoNCC 的 5min+ 栏目由句幽和痴者工良等作者联合推出,是一个利用您的碎片化时间来学习和丰富计算机专业知识与 .NET 知识的博文系列,它所包含 .NET 体系中可能会涉及到的方方面面,如 C# 的小细节、ASP.NET Core、微服务等。当我们在使用AspNet Core编写控制器的时候,经常会将一个Action的返回结果类型定义为IAct...

weixin_39852647的博客 818

KEPServerEX 6 之 EX 6.11.718.0 发布说明

KEPServerEX 6.11.718.0 发布说明

-雲飛兄-博客 2882

使用ASP.NET Core 3.x 构建 RESTful API - 3.3.3 ProblemDetails

当ASP.NET Core大约在2.1版本的时候,它引入了ProblemDetails。ProblemDetails是基于RFC7807这个规范,目的是让HTTP响应可以...

dotNET跨平台 771

蓝牙模块HM-10手册

蓝牙模块HM-10手册,该手册对蓝牙模块HM-10进行了详细的介绍和使用方法以及一些AT指令。

假人有限元模型

假人模型,车辆碰撞假人有限元模型,适合做乘员安全的研究者利用

logback的简单使用

1、前言 查了很多资料,都说logback的性能都要比log4j的性能要好,logback逐渐要取代log4j。今天对logback作一个简单的整理。 2、logback的依赖坐标 &lt;!-- &lt;dependency&gt; &lt;groupId&gt;org.slf4j&lt;/groupId&gt; &lt;artifactId&...

static_coder的博客 2万+

IMSL CNL 7.0.0 (x86-64)Crack

IMSL CNL 7.0.0 (x86-64)Crack intel的算法库破解文件,这是C++版本的破解文件

FORM表单的几大属性

FORM表单的几大属性问题引入 在做一个活动支付项目的时候,提交订单(form表单)跳转支付页面发现没有反应。经过断点排查发现断点也进了,不报错。但是返回的就是空白页,让人很纠结。 进过反复测试,才发现是杀毒软件拦截了form表单的请求。如何来解决这个问题呢?下来我们来看看Form表单的属性就会明白了。 FORM的属性 method属性:规定用于发送 form-data 的 HTTP

static_coder的博客 1万+

大中型超市收银系统(可直接运行)

光步前台收银系统系统功能:商品销售、商品退货、挂单、收银员权限、会员销售、单品取消、整单取消、商品查询、脱机销售、脱机数据上传,基本资料下载,开钱箱、小票打印、收款结算,支持多币种付款方式(现金、储值卡、礼券、微信等),支持多种促销。运行环境:.net 4.0登陆信息用户名:1001 密码:123456内置商品信息,商品编码可输入00001000 - 00010000,测试效果相关功能键F5 结算 F9挂单 F11商品查询 F8退货 Insert单品取消 Del整单取消 F12开钱箱F2 会员 Ctrl+Z退出系统 Home 锁屏 相关源码待公开

上一篇: 基于Netty的WebSocket自动解决拆包粘包问题
下一篇: 开源免费,开箱即用的年会抽奖工具
智_永无止境
博客等级 码龄10年 803粉丝 407原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

智_永无止境

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值