spring boot 全局异常处理通过 @restcontrolleradvice 捕获审计记录异常,核心做法是在拦截器或过滤器中执行审计逻辑时包裹 try-catch 块,将异常转换为日志记录或特定状态码,避免阻断主业务流程。具体实现需定义一个全局异常处理器类,使用 @exceptionhandler 注解指定要捕获的异常类型(如自定义的 auditexception),并在方法中返回统一的错误响应结构。这样当审计服务调用失败时,系统不会抛出 500 错误,而是返回友好的提示或静默忽略。

如何配置全局异常处理器来拦截审计异常
配置全局异常处理器需要创建一个继承自 ControllerAdvice 的类,并添加 @RestControllerAdvice 注解。在该类中定义处理方法,使用 @ExceptionHandler 指定具体的异常类型。例如,如果审计操作抛出 AuditServiceException,则该方法会捕获它。处理逻辑通常包括记录详细堆栈信息以便排查,然后返回一个标准的 JSON 响应对象,告知前端或调用方审计失败但业务请求已处理。这种方式解耦了异常处理与业务逻辑,确保所有控制器都能统一应用此规则。

import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.http.ResponseEntity;
import org.springframework.http.HttpStatus;
@RestControllerAdvice
public class GlobalAuditExceptionHandler {
@ExceptionHandler(AuditServiceException.class)
public ResponseEntity<string> handleAuditException(AuditServiceException ex) {
// 记录详细日志,不阻断主流程
System.err.println("Audit failed: " + ex.getMessage());
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
.body("Audit recording failed, but request processed.");
}
}</string>
如何在拦截器中优雅地处理审计异常而不影响主业务
在 Spring MVC 拦截器中执行审计逻辑时,必须将审计代码放入 try-catch 块中。如果审计服务不可用或数据写入失败,捕获异常后仅记录日志或发送异步消息,然后继续执行后续拦截链或放行请求。这样可以保证即使审计系统宕机,用户的主请求(如登录、下单)依然能正常完成。关键点是不要在拦截器的 afterCompletion 或 postHandle 中抛出未捕获的异常,否则会导致整个请求返回 500 错误。

import org.springframework.web.servlet.HandlerInterceptor;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class AuditInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
try {
auditService.record(request);
} catch (Exception e) {
// 静默处理或记录日志,不抛出异常
logger.error("Audit interception failed", e);
}
return true; // 继续执行后续逻辑
}
}
当审计数据库连接超时时的具体表现与处理策略
当审计数据库连接超时时,AuditServiceException 会被触发。在全局异常处理器中,可以针对此类异常进行特殊处理,例如返回特定的错误码供监控告警使用,或者尝试降级到本地文件记录。开发者应确保在主业务逻辑中不依赖审计结果的同步返回,从而避免因为数据库超时导致用户请求长时间挂起。通过上述配置,系统能够区分业务异常和基础设施异常,提供更稳定的服务体验。











