Java中可通过类级自定义注解+ConstraintValidator实现手机号与身份证号的组合校验，即“至少填一项”，需在注解中指定validatedBy，并在validator中通过getter获取多字段值联合判断。
在 Java 中，可以通过自定义注解 + ConstraintValidator 实现对手机号、身份证号等敏感字段的组合校验（比如“手机号或身份证号至少填一个”），而不是单字段独立校验。关键在于：注解需标注在类/方法上，校验逻辑在 ConstraintValidator 中访问整个对象，从而获取多个字段值进行联合判断。
1. 定义组合校验注解（类级注解）
该注解需作用于类（@Target(ElementType.TYPE)），并指定验证器实现类：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = ContactInfoValidator.class)
public @interface ValidContactInfo {
String message() default "手机号或身份证号必须填写至少一项";
Class<?>[] groups() default {};
Class<? extends Payload>[] payload() default {};
}
2. 编写 ConstraintValidator 实现类
继承 ConstraintValidator<ValidContactInfo, Object>，在 isValid 方法中强转为具体业务类，读取手机号和身份证号字段（推荐用 getter，避免反射字段名硬编码）：
public class ContactInfoValidator implements ConstraintValidator<ValidContactInfo, Object> {
@Override
public boolean isValid(Object value, ConstraintValidatorContext context) {
if (value == null) return true; // 让 @NotNull 处理空对象
String phone = null;
String idCard = null;
if (value instanceof UserForm) {
UserForm form = (UserForm) value;
phone = form.getPhone();
idCard = form.getIdCard();
}
// 去除首尾空格后判断是否非空
boolean hasPhone = !StringUtils.isBlank(phone);
boolean hasIdCard = !StringUtils.isBlank(idCard);
if (!hasPhone && !hasIdCard) {
// 禁用默认错误信息，自定义路径提示（可选）
context.disableDefaultConstraintViolation();
context.buildConstraintViolationWithTemplate(context.getDefaultConstraintMessageTemplate())
.addPropertyNode("phone").addConstraintViolation();
return false;
}
return true;
}
}
说明：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 使用
StringUtils.isBlank()（来自 Apache Commons Lang）兼容 null / 纯空格；若不用第三方库，可用Objects.toString(x, "").trim().length() == 0 - 校验失败时，可调用
context.disableDefaultConstraintViolation()自定义报错字段（如指向phone），提升前端定位体验 - 若实体类字段命名固定，也可用反射通用读取（但需处理异常、性能略低，不推荐初学使用）
3. 在 DTO 或表单类上使用注解
将 @ValidContactInfo 加在类上，并保留字段级基础校验（如格式、长度）：
@ValidContactInfo
public class UserForm {
private String name;
@Pattern(regexp = "^1[3-9]\d{9}$", message = "手机号格式不正确")
private String phone;
@Pattern(regexp = "^[1-9]\d{5}(18|19|20)\d{2}((0[1-9])|(1[0-2]))(([0-2][1-9])|10|20|30|31)\d{3}[0-9Xx]$",
message = "身份证号格式不正确")
private String idCard;
// getters & setters...
}
注意：
- 字段级注解（如
@Pattern）仍需保留，它们负责「格式合法」，而组合注解负责「业务必填逻辑」 - Spring MVC 中，只需在 Controller 方法参数加
@Valid即可触发整套校验
4. Controller 中启用校验
配合 Spring 的标准验证流程即可：
@PostMapping("/user")
public Result save(@Valid @RequestBody UserForm form) {
// 校验通过才执行
return userService.save(form);
}
若校验失败，Spring 会自动返回 400 Bad Request 并携带错误信息（可通过全局异常处理器统一格式化）。
不复杂但容易忽略的是：组合校验必须是类级注解，且验证器里要主动获取多个字段值——它不是替代单字段校验，而是补足业务规则维度。
