上周Code Review，一个新同事提交了100多行异常处理代码。一个 Result 类，一个 ResultCode 枚举，一个 GlobalExceptionHandler，再来一堆 try-catch。

我问："你知道Spring Boot 3已经内置了这套东西吗？"

他懵了。

大多数Java项目Controller里还在返回自封装的 Result，code=200/message="success"/data=xxx。这种约定没有错，但它有两个硬伤：第一，每个项目都得重新写一遍，代码重复但不完全一样，新项目上线别人得重新理解你的Result结构；第二，跟框架的异常处理链路是脱节的——参数校验失败走框架默认路径，业务异常走自定义Handler，两种格式不一致，前端要写两套解析逻辑。

Spring Boot 3的ProblemDetail机制就是来解决这个问题的，而且这玩意儿是RFC 7807国际标准，不是Spring自己拍脑袋发明的。

结论：三行配置替掉你的Result类

先看效果。假设你有个接口：

@GetMapping("/users/{id}")
public User getUser(@PathVariable Long id) {
    return userService.findById(id)
            .orElseThrow(() -> new UserNotFoundException(id));
}

不开ProblemDetail时，返回的是一串白标错误页面或JSON：

{
  "timestamp": "2026-06-29T10:30:00",
  "status": 404,
  "error": "Not Found",
  "path": "/users/999"
}

前端拿到这个，还得自己从 status 里推断到底出了什么问题。

开启ProblemDetail只需两件事。第一，application.yml 加一行：

spring:
  mvc:
    problemdetails:
      enabled: true # 开启RFC 7807支持

第二，自定义异常实现 ErrorResponseException：

// 业务异常统一继承ErrorResponseException，框架自动渲染
public class UserNotFoundException extends ErrorResponseException {

    public UserNotFoundException(Long userId) {
        // HttpStatus + ProblemDetail，框架自动拼装响应体
        super(HttpStatus.NOT_FOUND,
              ProblemDetail.forStatusAndDetail(HttpStatus.NOT_FOUND,
                  "用户 " + userId + " 不存在"), null);
        // 设置type URI：指向你的错误码文档，前端可据此跳转
        getBody().setType(URI.create("https://api.your-domain.com/errors/user-not-found"));
        getBody().setTitle("用户不存在");
    }
}

请求 /users/999，返回：

{
  "type": "https://api.your-domain.com/errors/user-not-found",
  "title": "用户不存在",
  "status": 404,
  "detail": "用户 999 不存在",
  "instance": "/users/999"
}

前端拿到这个后，直接读 type 就能路由到对应的错误提示，读 detail 就能展示给用户。不需要任何Result包装类。

它跟你的GlobalExceptionHandler怎么配合？

大部分人对ProblemDetail的误解是"那我原来写的 @RestControllerAdvice 是不是全废了"。不是，它是增强，不是替代。

原来的写法：

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(BusinessException.class)
    public Result handleBusiness(BusinessException e) {
        return Result.error(e.getCode(), e.getMessage());
    }
}

换成ProblemDetail版本，只需继承
ResponseEntityExceptionHandler：

@RestControllerAdvice
public class GlobalExceptionHandler extends ResponseEntityExceptionHandler {

    // 处理自定义业务异常，返回ProblemDetail而非Result
    @ExceptionHandler(BusinessException.class)
    public ProblemDetail handleBusiness(BusinessException e) {
        ProblemDetail pd = ProblemDetail.forStatusAndDetail(
                HttpStatus.BAD_REQUEST, e.getMessage());
        // 自定义扩展字段：带上业务错误码
        pd.setProperty("bizCode", e.getCode());
        pd.setProperty("timestamp", Instant.now());
        return pd; // 注意：直接返回ProblemDetail，不用包在ResponseEntity里
    }

    // 处理参数校验异常——这个以前要写一堆代码
    // 继承ResponseEntityExceptionHandler后，框架自动处理MethodArgumentNotValidException
    @Override
    protected ResponseEntity