Java中参数校验失败返回统一错误提示的核心是结合Spring Validation与全局异常处理：在Controller参数加@Valid/@Validated触发校验，用@ControllerAdvice捕获MethodArgumentNotValidException或ConstraintViolationException，提取FieldError生成标准响应，并支持自定义消息与国际化。

在 Java 中，参数校验失败时返回统一错误提示，核心是结合 Spring Validation（基于 JSR-303/JSR-380）与全局异常处理机制，避免每个接口手动判空或重复写错误响应逻辑。

使用 @Valid 或 @Validated 触发校验

在 Controller 方法参数上添加校验注解，让 Spring 自动拦截非法参数：

• 对单个对象参数加 @Valid（如 DTO），触发其内部字段上的 @NotBlank、@NotNull、@Min 等注解
• 对方法级校验（如分组校验、路径变量校验），可用 @Validated 配合校验组
• 示例：
  public Result addUser(@Valid @RequestBody UserDTO userDTO) { ... }

定义全局异常处理器捕获 MethodArgumentNotValidException

当 @Valid 校验失败，默认抛出 MethodArgumentNotValidException。用 @ControllerAdvice 统一拦截并封装成标准格式：

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 提取 BindingResult 中所有 FieldError，拼接或取第一条作为提示（推荐取最靠前的错误，避免前端展示过多）
• 返回统一结构，例如：{"code": 400, "msg": "用户名不能为空", "data": null}
• 注意：不要直接返回 BindingResult.toString()，它含大量调试信息，不友好

自定义错误消息 + 国际化支持（可选但推荐）

避免硬编码提示文本，提升可维护性：

立即学习“Java免费学习笔记（深入）”；

• 在 ValidationMessages.properties 中定义：
  userDTO.username.notBlank=用户名不能为空
• 注解中引用：
  @NotBlank(message = "{userDTO.username.notBlank}")
• Spring 会自动根据 Locale 解析对应语言文件（如 ValidationMessages_zh_CN.properties）

补充：路径变量和请求参数校验

@PathVariable 和 @RequestParam 不支持直接加 @Valid，需改用 @Validated + 方法级约束：

• 给 Controller 类加 @Validated
• 参数上使用 @NotBlank、@Min(1) 等，并确保参数名与校验注解匹配
• 同样由全局异常处理器捕获 ConstraintViolationException（不是 MethodArgumentNotValidException）