GlobalExceptionHandler.java
2.35 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
package com.xly.erp.common.exception;
import com.xly.erp.common.response.Result;
import com.xly.erp.common.response.ResultCode;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.dao.DuplicateKeyException;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
/**
* 全局异常处理（docs/04 § 1.5 SSoT）。
*
* <p>REQ-USR-001 T2：把 BusinessException / 参数校验失败 / 唯一键冲突 / 未捕获异常
* 统一转为 {@link Result}，失败响应不抛栈到前端。</p>
*/
@RestControllerAdvice
public class GlobalExceptionHandler {
private static final Logger LOG = LoggerFactory.getLogger(GlobalExceptionHandler.class);
/**
* 业务异常 → 对应错误码。
*/
@ExceptionHandler(BusinessException.class)
public <T> Result<T> handleBusinessException(BusinessException ex) {
return Result.fail(ex.getResultCode(), ex.getMessage());
}
/**
* Bean Validation（@Valid）失败 → 40001，message 取首个字段错误提示。
*/
@ExceptionHandler(MethodArgumentNotValidException.class)
public <T> Result<T> handleValidationException(MethodArgumentNotValidException ex) {
FieldError fieldError = ex.getBindingResult().getFieldError();
String message = fieldError != null
? fieldError.getField() + ": " + fieldError.getDefaultMessage()
: ResultCode.PARAM_INVALID.getMessage();
return Result.fail(ResultCode.PARAM_INVALID, message);
}
/**
* 唯一键冲突（并发兜底）→ 40901 用户名已存在。
*/
@ExceptionHandler(DuplicateKeyException.class)
public <T> Result<T> handleDuplicateKeyException(DuplicateKeyException ex) {
return Result.fail(ResultCode.USERNAME_EXISTS, ResultCode.USERNAME_EXISTS.getMessage());
}
/**
* 兜底：未捕获异常记录 ERROR 日志（含栈），对外只返回通用错误码，不泄露内部细节。
*/
@ExceptionHandler(Exception.class)
public <T> Result<T> handleException(Exception ex) {
LOG.error("系统异常", ex);
return Result.fail(ResultCode.SYSTEM_ERROR, ResultCode.SYSTEM_ERROR.getMessage());
}
}