通过自定义异常类、@ControllerAdvice全局处理和日志记录实现Java异常统一管理,提升系统可维护性与健壮性,规范异常抛出与响应格式。

在Java开发中,异常的统一管理能提升代码可读性、降低维护成本,并增强系统的健壮性。核心思路是通过自定义异常类、全局异常处理器和日志记录机制,集中处理项目中的各类异常情况。
项目中应避免直接抛出Exception或RuntimeException,而是创建有业务含义的异常类型。
例如,可以定义一个基础的业务异常:
public class BusinessException extends RuntimeException {
private String code;
public BusinessException(String message) {
super(message);
}
public BusinessException(String code, String message) {
super(message);
this.code = code;
}
// getter方法
public String getCode() {
return code;
}
}
根据业务模块,还可进一步细分异常类型,如UserServiceException、OrderNotFoundException等,便于定位问题。
立即学习“Java免费学习笔记(深入)”;
Spring Boot项目中,可以通过@ControllerAdvice注解定义全局异常处理器。
创建一个异常处理类:
@ControllerAdvice
public class GlobalExceptionHandler {
@ResponseBody
@ExceptionHandler(BusinessException.class)
public Map<String, Object> handleBusinessException(BusinessException e) {
Map<String, Object> result = new HashMap<>();
result.put("success", false);
result.put("code", e.getCode() != null ? e.getCode() : "500");
result.put("message", e.getMessage());
return result;
}
@ResponseBody
@ExceptionHandler(NullPointerException.class)
public Map<String, Object> handleNPE(NullPointerException e) {
Map<String, Object> result = new HashMap<>();
result.put("success", false);
result.put("code", "500");
result.put("message", "系统发生了空指针异常,请联系管理员");
return result;
}
@ResponseBody
@ExceptionHandler(Exception.class)
public Map<String, Object> handleOtherException(Exception e) {
Map<String, Object> result = new HashMap<>();
result.put("success", false);
result.put("code", "500");
result.put("message", "系统内部错误");
// 记录日志
log.error("未捕获的异常:", e);
return result;
}
}
这样所有控制器中抛出的异常都会被集中处理,返回格式统一的响应结果。
本系统经过多次升级改造,系统内核经过多次优化组合,已经具备相对比较方便快捷的个性化定制的特性,用户部署完毕以后,按照自己的运营要求,可实现快速定制会费管理,支持在线缴费和退费功能财富中心,管理会员的诚信度数据单客户多用户登录管理全部信息支持审批和排名不同的会员级别有不同的信息发布权限企业站单独生成,企业自主决定更新企业站信息留言、询价、报价统一管理,分系统查看分类信息参数化管理,支持多样分类信息,
0
异常发生时,除了向前端返回提示,还应记录详细日志用于排查。
在全局处理器中加入日志输出:
private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class);
在catch块或@ExceptionHandler方法中调用log.error(),确保堆栈信息写入日志文件。
建议记录的内容包括:异常类型、消息、堆栈、发生时间、请求路径、用户ID(如有)等上下文信息。
在业务代码中,避免吞掉异常或只打印堆栈而不处理。
例如:
if (user == null) {
throw new BusinessException("USER_NOT_FOUND", "用户不存在");
}
基本上就这些。通过统一异常结构、全局拦截和日志追踪,能让Java应用的错误处理更整洁高效。关键是团队遵守约定,不随意抛出原始异常。
以上就是如何在Java中实现异常的统一管理的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号