为什么要使用错误码，直接返回一个错误信息不好么？
下面介绍一下，在程序开发中使用错误码的必要性~
便于排查问题
想象你开了一家奶茶店，顾客下单后可能出现各种问题：
- 没珍珠了（错误码：5001）
- 杯子不够了（错误码：5002）
- 支付失败（错误码：5003）
如果店员直接对顾客喊：“那个…机器坏了（错误码：500）！我也不知道为啥！”，顾客肯定一头雾水。但如果用更加具体的错误码：
- 顾客看到 “错误码 5001”，直接知道 “哦，没珍珠了，换椰果吧”。
- 老板看到 “错误码 5003”，马上检查支付系统。
避免 freestyle、方便统计
对于“用户不存在”这一错误，不同的程序员会有不同的表述，比如：
- 程序员A写：“用户没找到”
- 程序员B写：“用户不存在”
- 程序员C写：“查无此人”
其实都是同一件事，但看起来像三种错误。而用错误码后就可以统一成 “1001”，大家看到这个码，都知道是“用户不存在”。
此外，如果老板需要统计由于“用户不存在”导致的错误数量有多少时，就可以通过 “1001” 去搜。
便于多端协作
比如前端、移动端或第三方服务需要根据错误类型执行不同逻辑（如跳转登录页、展示特定提示）。就可以通过错误码约定行为：
if (errorCode == 401) {// 跳转登录页
} else if (errorCode == 403) {// 提示权限不足
}
支持国际化
方法返回错误码，再根据语言环境映射到对应的翻译文本：
// 中文环境
{ "code": 1001, "message": "用户不存在" }// 英文环境
{ "code": 1001, "message": "User not found" }
最佳实践
1.定义错误码枚举类
public enum ErrorCode {SUCCESS(0, "ok"),PARAMS_ERROR(40000, "请求参数错误"),NOT_LOGIN_ERROR(40100, "未登录"),NO_AUTH_ERROR(40101, "无权限"),NOT_FOUND_ERROR(40400, "请求数据不存在"),FORBIDDEN_ERROR(40300, "禁止访问"),SYSTEM_ERROR(50000, "系统内部异常"),OPERATION_ERROR(50001, "操作失败");/*** 状态码*/private final int code;/*** 信息*/private final String message;ErrorCode(int code, String message) {this.code = code;this.message = message;}public int getCode() {return code;}public String getMessage() {return message;}
}
2.方法返回包含错误码信息的通用返回对象
@PostMapping("/add")public BaseResponse<Long> addChart(@RequestBody ChartAddRequest chartAddRequest, HttpServletRequest request) {if (chartAddRequest == null) {throw new BusinessException(ErrorCode.PARAMS_ERROR);}Chart chart = new Chart();BeanUtils.copyProperties(chartAddRequest, chart);User loginUser = userService.getLoginUser(request);chart.setUserId(loginUser.getId());boolean result = chartService.save(chart);ThrowUtils.throwIf(!result, ErrorCode.OPERATION_ERROR);long newChartId = chart.getId();return ResultUtils.success(newChartId);}
3.全局捕获异常
@RestControllerAdvice
@Slf4j
public class GlobalExceptionHandler {// 捕获业务异常（代码编写时主动抛出）@ExceptionHandler(BusinessException.class)public BaseResponse<?> businessExceptionHandler(BusinessException e) {log.error("BusinessException", e);return ResultUtils.error(e.getCode(), e.getMessage());}// 捕获运行时异常，代码编写时未能发现的异常，比如空指针@ExceptionHandler(RuntimeException.class)public BaseResponse<?> runtimeExceptionHandler(RuntimeException e) {log.error("RuntimeException", e);return ResultUtils.error(ErrorCode.SYSTEM_ERROR, "系统错误");}
}
