在Java中如何实现全局异常统一处理-java教程-PHP中文网

在Java中如何实现全局异常统一处理

P粉602998670

发布： 2025-10-22 20:47:01

原创

951人浏览过

通过@ControllerAdvice和@ExceptionHandler实现全局异常处理，结合自定义异常类与ResponseStatus注解，统一返回结构化响应，提升代码可维护性与用户体验。

在java中如何实现全局异常统一处理

在Java开发中，特别是在使用Spring或Spring Boot框架时，实现全局异常统一处理可以有效提升代码的可维护性和用户体验。通过集中处理异常，避免重复的try-catch代码，同时能统一返回格式，便于前端解析。

使用@ControllerAdvice和@ExceptionHandler

这是Spring提供的最常用方式，通过定义一个被@ControllerAdvice注解的类，配合@ExceptionHandler来捕获控制器中抛出的异常。

示例代码：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(NullPointerException.class)
    public ResponseEntity<String> handleNullPointer(NullPointerException e) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
                .body("发生了空指针异常：" + e.getMessage());
    }

    @ExceptionHandler(IllegalArgumentException.class)
    public ResponseEntity<String> handleIllegalArgument(IllegalArgumentException e) {
        return ResponseEntity.status(HttpStatus.BAD_REQUEST)
                .body("参数错误：" + e.getMessage());
    }

    @ExceptionHandler(Exception.class)
    public ResponseEntity<Map<String, Object>> handleGeneralException(Exception e) {
        Map<String, Object> response = new HashMap<>();
        response.put("error", "服务器内部错误");
        response.put("message", e.getMessage());
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(response);
    }
}

登录后复制

这个类会拦截所有Controller中抛出的指定异常，并返回结构化的响应结果。

立即学习“Java免费学习笔记（深入）”；

自定义业务异常类

为了更清晰地区分系统异常和业务异常，建议定义自己的异常类。

动感购物HTML

修正了V1.10的一些BUG感购物HTML系统是集合目前网络所有购物系统为参考而开发，代码采用DIV编号，不管从速度还是安全我们都努力做到最好，此版虽为免费版但是功能齐全，无任何错误，特点有：专业的、全面的电子商务解决方案，使您可以轻松实现网上销售；自助式开放性的数据平台，为您提供充满个性化的设计空间；功能全面、操作简单的远程管理系统，让您在家中也可实现正常销售管理；严谨实用的全新商品数据库，便于

查看详情

public class BusinessException extends RuntimeException {
    public BusinessException(String message) {
        super(message);
    }
}

登录后复制

在业务逻辑中直接抛出：

if (user == null) {
    throw new BusinessException("用户不存在");
}

登录后复制

然后在GlobalExceptionHandler中添加对应处理方法：

@ExceptionHandler(BusinessException.class)
public ResponseEntity<Map<String, Object>> handleBusinessException(BusinessException e) {
    Map<String, Object> response = new HashMap<>();
    response.put("error", "业务异常");
    response.put("message", e.getMessage());
    return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(response);
}

登录后复制

结合ResponseStatus注解简化处理

可以在自定义异常上使用@ResponseStatus注解，直接指定HTTP状态码，减少在ExceptionHandler中的重复配置。

@ResponseStatus(value = HttpStatus.NOT_FOUND, reason = "用户未找到")
public class UserNotFoundException extends RuntimeException {
    public UserNotFoundException(String message) {
        super(message);
    }
}

登录后复制

这样当该异常被抛出时，Spring会自动返回404状态码，无需额外在ControllerAdvice中写处理逻辑（除非需要定制返回体）。

基本上就这些。通过@ControllerAdvice统一捕获异常，配合自定义异常类和合理的返回结构，就能实现清晰、可维护的全局异常处理机制。不复杂但容易忽略细节。

以上就是在Java中如何实现全局异常统一处理的详细内容，更多请关注php中文网其它相关文章！