在 spring boot 中校验身份证号,最标准且可维护的做法是引入 hibernate-validator 依赖,并在实体类字段上添加自定义的 @valididcard 注解。该注解底层通过正则表达式匹配 18 位或 15 位身份证格式,并增加了对校验码(最后一位)的合法性验证,从而确保输入的数据既符合格式规范又具备逻辑有效性。

如何定义支持校验码验证的自定义注解
要实现精确的身份证号校验,不能仅依赖简单的正则,必须处理校验码。我们需要创建一个名为 ValidIdCard 的注解,并将其关联到一个实现了 ConstraintValidator 接口的校验器类中。这个校验器会接收用户输入的字符串,先判断是否为空,再使用正则进行格式初筛,最后通过加权求和算法验证第 18 位的校验码是否正确。

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Constraint(validatedBy = IdCardValidator.class)
public @interface ValidIdCard {
String message() default "身份证号格式不正确";
Class>[] groups() default {};
Class extends Payload>[] payload() default {};
}
import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
import java.util.regex.Pattern;
public class IdCardValidator implements ConstraintValidator<valididcard string> {
private static final Pattern PATTERN = Pattern.compile("^(\d{6})(19|20)\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])\d{3}[\dXx]$");
@Override
public boolean isValid(String value, ConstraintValidatorContext context) {
if (value == null || value.isEmpty()) return true; // 由 @NotBlank 处理空值
if (!PATTERN.matcher(value).matches()) return false;
int[] w = {7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2};
char[] checkCode = {'1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'};
int sum = 0;
for (int i = 0; i <p>上述代码定义了校验的核心逻辑。当 Spring MVC 接收到请求时,如果字段未通过此校验,将自动抛出 <code>MethodArgumentNotValidException</code>,你可以通过全局异常处理器将其转换为统一的 JSON 错误响应。这种解耦方式使得业务代码无需手动编写复杂的判断语句。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill6631" title="Spring Boot Actuator Analyzer"><img
src="https://img.php.cn/upload/skill/000/000/081/179103250068943.jpg" alt="Spring Boot Actuator Analyzer" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill6631" title="Spring Boot Actuator Analyzer" class="overflowclass">Spring Boot Actuator Analyzer</a>
<p class="overflowclass">分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。</p>
</div>
<a rel="nofollow" href="/xiazai/skill6631" title="Spring Boot Actuator Analyzer" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<h2>如何在 Controller 层启用参数绑定与校验</h2>
<p>定义好注解后,需要在 Controller 的方法参数中使用 <code>@Valid</code> 或 <code>@Validated</code> 来触发校验机制。通常我们会创建一个 DTO(数据传输对象)来接收前端传来的数据,并在该 DTO 的 <code>idCard</code> 字段上应用我们刚才定义的 <code>@ValidIdCard</code> 注解。这样,Spring 会在方法执行前自动完成校验工作。</p>
<p><img src="https://img.php.cn/upload/article/001/242/473/179488599214795.png?x-oss-process=image/resize,p_40" alt="Spring Boot 参数校验怎么校验身份证号"></p>
<pre class="brush:php;toolbar:false;">@Valid










