java参数校验失败时应统一拦截异常并封装结构化错误响应：①用@valid+bindingresult手动处理；②全局捕获methodargumentnotvalidexception；③自定义注解支持业务语义错误码；④错误码需模块化、可读、带提示。
Java 中参数校验不通过时，返回友好的错误码关键在于统一拦截校验异常、提取有效信息，并封装成前端可读的响应结构。不是简单 throw 一个 RuntimeException 就完事，而是要有标准格式、明确错误码、带上下文提示。
用 @Valid + BindingResult 手动捕获（适合 Controller 层局部校验）
适用于少量接口、或需要自定义处理逻辑的场景。在方法参数后紧跟 BindingResult，它会自动接收校验失败结果：
- 校验注解（如
@NotBlank、@Min(1)）写在 DTO 字段上 - Controller 方法签名形如：
public Result> addUser(@Valid @RequestBody UserDTO dto, BindingResult result) - 若
result.hasErrors()为 true，遍历result.getFieldErrors()提取字段名、错误信息、甚至自定义错误码 - 推荐把每个校验注解映射到预设错误码，例如
@NotBlank→40001，@Email→40002
全局统一拦截 MethodArgumentNotValidException（推荐主流做法）
Spring Boot 默认对 @Valid 失败抛出 MethodArgumentNotValidException，用 @ControllerAdvice 全局捕获最干净：
- 定义统一异常处理器，@ExceptionHandler(MethodArgumentNotValidException.class)
- 从异常中获取
BindingResult，再遍历所有FieldError - 每个
FieldError可调用getField()、getDefaultMessage()，结合 ResourceBundle 或 switch 判断，生成结构化错误信息 - 返回 JSON 示例：
{"code":400,"msg":"请求参数错误","data":{"username":"用户名不能为空","age":"年龄不能小于1"}}
自定义校验注解 + ConstraintValidator（支持业务语义错误码）
当内置注解不够用（比如“手机号必须是 11 位且以 1 开头”），可写自定义注解，同时在 ConstraintValidator 实现里直接指定错误码：
- 定义注解如
@ValidMobile(code = "40010", message = "手机号格式不正确") - 实现类中 validate() 方法返回 false 时，可通过
context.buildConstraintViolationWithTemplate(...)绑定提示，或额外往 context.setAttribute() 存错误码 - 全局异常处理器中从
ConstraintViolation提取自定义属性，组装进响应
错误码设计建议（让前端真正友好）
错误码不是随便编的数字，要兼顾可读性、可维护性和扩展性：
- 按模块分段：如
4001001表示「用户模块-注册接口-手机号格式错误」 - 保留前缀含义：4xx 表示客户端错误，5xx 是服务端错误；第二位区分子系统（如 4001xx 用户，4002xx 订单）
- 配套维护一份 error-code.md 文档，开发/测试/前端共用
- 避免只返回错误码不带提示——即使 code=4001001，也要附带 message: "手机号必须为11位数字，且以1开头"
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
