当你使用Spring Boot(Spring MVC)进行RESTful API开发的时候，你会发现HTTP的状态码很多时候不能足够有效的传递错误的信息。
HTTP里有一个RFC 7807规范：https://HdhCmsTestrfc-editor.org/rfc/rfc7807。这个规范里定义了HTTP API的[问题细节]（Problem Details）内容。
该规范定义了一个[问题细节]（Problem Details），用它来携带HTTP错误返回信息，避免自定义新的错误返回格式。我们通常情况下是自己定义错误返回格式的。
Spring 6.0为我们提供了一个org.springframework.http.ProblemDetail 来实现该规范。
RFC 7807是一个很简单的规范。它定义了一个JSON格式，并关联了一个媒体类型（media type），这个JSON格式包含了五个可选成员来描述问题细节：
type：一个URI引用，用来识别问题的类型。这个URI的路径内容应该用来显示人类可读的信息来描述类型；
title：人类可读的问题类型描述；相同类型的问题，应该总是相同的描述；
status：HTTP状态码，将它包含在问题细节里是一种方便的方式；
detail：人类可读的问题实例描述，解释为什么当前的问题发生在这个特定的场景下；
instance：一个URI引用，用来识别问题实例。这个URI的内容应该用来描述问题实例，但不是必须的。
我们首先建立一个演示项目：
1、通常的业务异常处理方法
定义一个业务异常类。异常含义为：当Person找不到的时候抛出的业务异常。
public class PersonNotFoundException extends RuntimeException { @Getter
private final HttpStatus status ; public PersonNotFoundException ( String message , HttpStatus status ) { super ( message ) ; this .status = status ; } }
注册这个业务异常到全局异常处理。
通过在@RestControllerAdvice 中定义全局的切面处理。
通过@ExceptionHandler 来处理指定异常的处理方式。
这里返回的格式就是我们自定义的ErrorMsg格式。我们通过自定义这个ErroMsg完成和接口使用者协议，完成对业务异常的处理。
@RestControllerAdvice
public class GlobalExceptionHandler { @ExceptionHandler ( PersonNotFoundException .class ) public ResponseEntity < ErrorMsg > personNotFoundHandler ( PersonNotFoundException e ) { ErrorMsg msg = new ErrorMsg ( "0000" , e .getMessage ( ) ) ; return new ResponseEntity <> ( msg , e .getStatus ( ) ) ; } }
需自定义的错误返回
@Data
@AllArgsConstructor
@NoArgsConstructor
public class ErrorMsg { private String code ; private String msg ; }
测试控制器
@RestController
public class PersonController { @GetMapping ( "/getPerson" ) public String getPerson ( ) { throw new PersonNotFoundException ( "查找的人不存在" , HttpStatus .NOT_FOUND ) ; } }
启动程序，访问：http://localhost:8080/getPerson
2、基于[问题细节]的业务异常处理
基于我们常规的异常处理，其实已经能满足我们的业务需求，使用RFC 7807规范，我们可以免去自定义的异常错误格式（ErrorMsg ），使用Spring 6.0给我们提供的ProblemDetail ，这样我们以后再无需自己自定义异常返回格式，且在不同的项目之间有了标准，从而客户端在使用的时候有了可预测性。
Spring 6.0的做法也很简单，我们只需要将我们自定返回的ErrorMsg 修改成ProblemDetail 即可。我们看一下示例代码：
@RestControllerAdvice
public class GlobalExceptionHandler { @ExceptionHandler ( PersonNotFoundException .class ) public ProblemDetail personNotFoundHandler ( PersonNotFoundException e ) { ProblemDetail problemDetail = ProblemDetail .forStatus ( HttpStatus .NOT_FOUND ) ; problemDetail .setType ( URI .create ( "https://HdhCmsTesttoutiao测试数据/c/user/token/MS4wLjABAAAAJxW0bvHKNNwIpcsocIDAjNHHNXg2yaj1upViHO2JVNw/" ) ) ; problemDetail .setTitle ( "Person Not Found" ) ; problemDetail .setDetail ( String .format ( "错误信息：‘%s’" , e .getMessage ( ) ) ) ; return problemDetail ; } }
值得说的是ProblemDetail 还支持设置一个Map的properties：
private Map < String , Object > properties ;
这样也为我们的定制扩展提供了更大的空间。
启动，访问：http://localhost:8080/getPerson，其实的错误返回符合RFC 7807规范。
注意查看返回的头信息，我们看到了，返回数据的媒体类型为：application/problem+json：
感谢支持我的书：《从企业级开发到云原生微服务:Spring Boot实战》
参考资料：https://docs.spring.io/spring-framework/docs/6.0.0-RC2/javadoc-api/org/springframework/http/ProblemDetail.html
文章出自：爱科学的卫斯理，如有转载本文请联系爱科学的卫斯理今日头条号。
原文地址：https://HdhCmsTesttoutiao测试数据/article/7158309490746589727/
查看更多关于Spring 6/Spring Boot 3新特性：优雅的业务异常处理的详细内容...