spring boot 默认无法直接校验 map 的键值，因为 map 不是 java bean。要校验 map 的键和值，需要自定义一个 constraintvalidator，并在 map 的值对象上应用标准的 bean validation 注解。
如何定义支持嵌套校验的 Map 约束？
通过实现 ConstraintValidator 接口，可以遍历 Map 并检查每个值的合法性。关键在于使用 ValidationContext 或手动触发校验来确保嵌套对象的字段也被验证。
import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Constraint(validatedBy = MapValueValidator.class)
public @interface ValidMapValues {
String message() default "Invalid map values";
Class<?>[] groups() default {};
Class<? extends Payload>[] payload() default {};
}
import org.springframework.beans.factory.annotation.Autowired;
import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
import javax.validation.Validation;
import javax.validation.Validator;
import java.util.Map;
public class MapValueValidator implements ConstraintValidator<ValidMapValues, Map<String, Object>> {
@Autowired
private Validator validator;
@Override
public boolean isValid(Map<String, Object> value, ConstraintValidatorContext context) {
if (value == null) return true;
for (Object obj : value.values()) {
if (obj != null && !validator.validate(obj).isEmpty()) {
return false;
}
}
return true;
}
}
如何在 Controller 中启用校验并获取错误信息？
在 Controller 方法参数前添加 @Valid 注解，并使用 BindingResult 捕获校验失败的具体字段和消息。这样可以将详细的校验错误返回给前端。
import org.springframework.web.bind.annotation.*;
import javax.validation.Valid;
import java.util.HashMap;
import java.util.Map;
@RestController
@RequestMapping("/api")
public class DataController {
@PostMapping("/data")
public String submitData(@RequestBody @Valid Map<String, MyData> data,
BindingResult result) {
if (result.hasErrors()) {
return result.getAllErrors().toString();
}
return "Success";
}
}
当 Map 值为空时校验行为如何？
如果 Map 中的某个值为 null，且该值对应的类字段没有 @NotNull 约束，则不会报错。若需强制非空，需在值对象上添加相应注解。
