Spring数据验证冗余边界、字段转换及校验方案选型咨询

以下场景下的数据验证属于完全没必要写的冗余逻辑：

• 同规则重复校验：比如POJO字段上已经加了@NotNull、@Email这类标准校验注解，又在Controller、Service层手写一模一样的非空、格式判断逻辑；或者Controller和Service层写了完全无差异的校验规则，没有新增任何业务判断。
• 框架已自动完成的校验重复写：比如配置了Jackson日期反序列化规则后，非法格式的日期字符串会在JSON转对象阶段直接抛出异常，根本到不了业务代码，这时候再手动写逻辑判断传入的日期字符串能不能解析就是冗余。
• 无意义的透传校验：比如私有方法内部的参数，调用方已经是自己可控的内部代码，再重复做一遍和入口层完全一样的参数校验就是冗余。

注意：客户端前置校验只用于优化用户体验，绝对不能因为客户端做了校验就省略服务端校验，这部分不属于冗余。

问题1：POST请求中指定JSON字段的类型转换实现 #

不需要写自定义拦截器截取字段，两种成熟方案直接用：

1. 单字段指定格式：直接在User实体的birthDate字段上加Jackson和Spring的格式注解，框架会自动把传入的符合格式的String转成LocalDate，格式不对直接抛出参数解析异常，全局捕获后返回400即可：

@JsonFormat(pattern = "yyyy-MM-dd")
@DateTimeFormat(pattern = "yyyy-MM-dd")
private LocalDate birthDate;

pattern的值改成你前端实际传的日期格式就行，比如yyyy/MM/dd。
2. 全局统一配置：如果项目里所有LocalDate类型都用同一种格式传，直接配置全局Jackson反序列化规则，一次配置所有接口生效，不需要每个字段加注解。

问题2：两类校验的适用场景与推荐实现模式 #

两类校验的定位 #

• POJO上的校验注解（JSR-380标准注解，比如@NotNull/@Length/@Email）：只适用于和具体业务逻辑无关的通用规则校验，比如字段非空、字符串长度限制、邮箱/手机号格式校验这类不涉及业务判断、不关联其他字段、不需要查库的规则。用的时候只需要在Controller方法的@RequestBody参数前加@Valid/@Validated注解，Spring会自动在参数绑定完成后触发校验，校验失败直接抛异常，不需要手写判断逻辑。
• Controller/自定义验证器里的手写校验逻辑：只适用于和业务场景强绑定的校验规则，比如“注册时两次输入密码一致”“用户名不能包含敏感词”“生日不能晚于当前日期”“用户名不能和已存在用户重复”这类没法用通用注解实现、需要关联其他字段或者查询数据库的规则。

是否需要同时使用 #

只要规则不重复就需要同时用，核心是不要做重复判断——比如POJO上已经加了@NotNull限制firstName必填，就不要在自定义验证器里再写if (user.getFirstName() == null)这类重复代码，这部分就是前面说的冗余逻辑。

通用落地模式 #

行业内通用的服务端校验是分层做的，每层只负责自己的校验范围，不重复写规则：

1. 第一层：JSON反序列化层，靠Jackson等序列化框架兜住类型不匹配问题，比如日期格式错、数字字段传字符串，这层靠全局配置实现，不需要写业务代码。
2. 第二层：注解式通用校验，靠@Valid触发POJO上的标准注解校验，兜住所有通用的非空、长度、格式规则，不需要手写重复判断。
3. 第三层：业务规则校验，放在自定义校验器或者Service层，处理所有和业务相关的关联校验、查库校验。
4. 第四层：数据库约束兜底，靠数据库的非空、唯一、长度约束，防止上层校验漏过的非法数据落库。

你当前代码的问题 #

你现在贴的代码里，POJO上的校验注解完全没生效——因为@RequestBody参数前没加@Valid注解，Spring不会自动触发这些注解的校验逻辑，等于你写的@NotNull/@Email现在全是无效代码。另外你现在的自定义校验器如果包含了非空、格式这类通用判断，那部分就是冗余逻辑。
调整后的Controller代码参考：

@PostMapping
public ResponseEntity addUser(@Valid @RequestBody User user, BindingResult bindingResult) {
    // 先处理注解式通用校验的结果
    if (bindingResult.hasErrors()) {
        logger.info("通用参数校验不通过: {}", bindingResult.getAllErrors());
        return new ResponseEntity(HttpStatus.BAD_REQUEST);
    }
    // 只处理注解覆盖不到的业务校验
    UserValidation.ValidationResult result = userValidationService.validate(user);
    if (result.equals(UserValidation.ValidationResult.SUCCESS)){
        logger.info("Added a new user.");
        userService.addUser(user);
        return ResponseEntity.ok(HttpStatus.OK);
    }
    logger.info("业务规则校验不通过，无法新增用户");
    return new ResponseEntity(HttpStatus.BAD_REQUEST);
}

内容的提问来源于stack exchange，提问作者thottivelli