快捷導(dǎo)航

SpringBoot全局異常處理與日志記錄的統(tǒng)一規(guī)范實(shí)戰(zhàn)

更新時(shí)間：2026年07月08日 09:11:23 作者：張老師技術(shù)棧

線上系統(tǒng)出問題不可怕,可怕的是出了問題找不到原因,統(tǒng)一的異常處理和規(guī)范的日志記錄是任何生產(chǎn)系統(tǒng)必備的基礎(chǔ)設(shè)施,本文教你用全局異常處理+統(tǒng)一日志記錄,快速定位線上Bug,掌握自定義異常、攔截器配置和日志級(jí)別調(diào)優(yōu),徹底告別排查難題,需要的朋友可以參考下

一、全局異常處理

1. 自定義業(yè)務(wù)異常

public class BusinessException extends RuntimeException {
    private int code;
    private String message;

    public BusinessException(int code, String message) {
        super(message);
        this.code = code;
        this.message = message;
    }

    // 常用錯(cuò)誤碼
    public static BusinessException notFound(String msg) {
        return new BusinessException(404, msg);
    }

    public static BusinessException badRequest(String msg) {
        return new BusinessException(400, msg);
    }

    public static BusinessException unauthorized(String msg) {
        return new BusinessException(401, msg);
    }

    public static BusinessException forbidden(String msg) {
        return new BusinessException(403, msg);
    }
}

2. 全局異常處理器

@RestControllerAdvice
public class GlobalExceptionHandler {

    private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class);

    @ExceptionHandler(BusinessException.class)
    public ResultVO<?> handleBusiness(BusinessException e) {
        log.warn("業(yè)務(wù)異常: code={}, msg={}", e.getCode(), e.getMessage());
        return ResultVO.error(e.getCode(), e.getMessage());
    }

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResultVO<?> handleValidation(MethodArgumentNotValidException e) {
        String msg = e.getBindingResult().getFieldErrors().stream()
            .map(FieldError::getDefaultMessage)
            .collect(Collectors.joining("；"));
        return ResultVO.error(400, msg);
    }

    @ExceptionHandler(ConstraintViolationException.class)
    public ResultVO<?> handleConstraint(ConstraintViolationException e) {
        String msg = e.getConstraintViolations().stream()
            .map(ConstraintViolation::getMessage)
            .collect(Collectors.joining("；"));
        return ResultVO.error(400, msg);
    }

    @ExceptionHandler(NoHandlerFoundException.class)
    public ResultVO<?> handle404(NoHandlerFoundException e) {
        return ResultVO.error(404, "接口不存在: " + e.getRequestURL());
    }

    @ExceptionHandler(Exception.class)
    public ResultVO<?> handleOther(Exception e) {
        log.error("系統(tǒng)異常", e);
        return ResultVO.error(500, "服務(wù)器繁忙，請(qǐng)稍后重試");
    }
}

二、統(tǒng)一日志記錄

1. 請(qǐng)求日志攔截器

@Component
public class LogInterceptor implements HandlerInterceptor {

    private static final Logger log = LoggerFactory.getLogger(LogInterceptor.class);

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response,
                             Object handler) {
        // 記錄請(qǐng)求開始時(shí)間
        request.setAttribute("startTime", System.currentTimeMillis());
        return true;
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response,
                                Object handler, Exception ex) {
        long start = (long) request.getAttribute("startTime");
        long duration = System.currentTimeMillis() - start;

        log.info("[{}] {} {} → {} ({}ms)",
            request.getMethod(),
            request.getRequestURI(),
            request.getQueryString() != null ? "?" + request.getQueryString() : "",
            response.getStatus(),
            duration
        );
    }
}

2. 注冊(cè)攔截器

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Autowired
    private LogInterceptor logInterceptor;

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(logInterceptor)
                .addPathPatterns("/api/**");
    }
}

3. 日志級(jí)別配置

logging:
  level:
    root: INFO
    com.zhang: DEBUG
    com.zhang.seckill.mapper: TRACE
  file:
    path: /var/log/app
    name: ${logging.file.path}/app.log
  logback:
    rolling policy:
      max-history: 30
      max-file-size: 100MB

三、日志最佳實(shí)踐

// ? 正確：帶參數(shù)占位符
log.info("用戶 {} 創(chuàng)建訂單 {}", userId, orderNo);

// ? 錯(cuò)誤：字符串拼接
log.info("用戶 " + userId + " 創(chuàng)建訂單 " + orderNo);

// ? 正確：包含上下文信息
log.warn("支付失敗: orderNo={}, amount={}, error={}", orderNo, amount, error);

// ? 錯(cuò)誤：沒信息量的日志
log.info("支付失敗");

到此這篇關(guān)于SpringBoot全局異常處理與日志記錄的統(tǒng)一規(guī)范實(shí)戰(zhàn)的文章就介紹到這了,更多相關(guān)SpringBoot全局異常處理與日志記錄統(tǒng)一規(guī)范內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: