Spring Boot中如何验证java.lang.Boolean类型字段？

首先，你遇到的UnexpectedTypeException是因为@Pattern注解仅支持字符串类型的校验，而你的字段是java.lang.Boolean，Hibernate Validator找不到对应的校验器，所以报错了。下面给出几种针对性的解决方案：

方案1：从JSON反序列化层面阻止（推荐） #

如果你的场景是前端通过JSON请求体传递参数，Spring Boot默认使用Jackson进行反序列化。Jackson默认会把字符串"true"/"false"自动转换成Boolean类型，你可以禁用这个特性，让它只接受无引号的布尔值：

配置Jackson禁用字符串转布尔值 #

创建一个Jackson配置类：

import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper objectMapper = new ObjectMapper();
        // 禁用接受字符串作为布尔值的转换
        objectMapper.disable(DeserializationFeature.ACCEPT_STRING_AS_BOOLEAN);
        return objectMapper;
    }
}

配置后，当前端传递带引号的"true"/"false"时，Jackson会直接抛出反序列化异常，提示无法将字符串转换为布尔类型，从根源上阻止了非法输入。

方案2：自定义校验注解（适用于更灵活的校验场景） #

如果你需要在实体类字段上做显式校验，可以自定义一个针对Boolean类型的校验注解。不过要注意：Boolean类型本身只能是true或false，但如果是从字符串转换过来的，这个转换发生在校验之前，所以这个方案更适合配合参数绑定的自定义转换一起使用。

步骤1：创建自定义校验注解 #

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;

@Documented
@Constraint(validatedBy = StrictBooleanValidator.class)
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
public @interface StrictBoolean {
    String message() default "Only unquoted true/false are allowed for this field";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

步骤2：实现校验器 #

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;

public class StrictBooleanValidator implements ConstraintValidator<StrictBoolean, Boolean> {
    @Override
    public boolean isValid(Boolean value, ConstraintValidatorContext context) {
        // 这里其实Boolean类型本身只能是true/false，所以这个校验主要是配合参数绑定的自定义转换
        // 如果参数绑定阶段已经阻止了字符串转布尔值，这里只要判断value不为null即可（根据你的需求）
        return value != null;
    }
}

步骤3：配合自定义参数转换器（可选） #

如果是表单参数或URL参数传递，需要自定义转换器，拒绝字符串类型的布尔值：

import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;

@Component
public class StringToBooleanConverter implements Converter<String, Boolean> {
    @Override
    public Boolean convert(String source) {
        if ("true".equalsIgnoreCase(source)) {
            return Boolean.TRUE;
        } else if ("false".equalsIgnoreCase(source)) {
            return Boolean.FALSE;
        } else {
            throw new IllegalArgumentException("Invalid boolean value: " + source);
        }
    }
}

这样，当传递非"true"/"false"的字符串时，会抛出参数转换异常，配合自定义校验注解可以完成严格校验。

方案3：临时转换为String字段校验 #

如果以上方案都不适用，你可以临时把字段类型改为String，用@Pattern校验后再转换为Boolean：

@Pattern(regexp = "^(true|false)$", message = "restartable field allowed input: true or false")
private String restartable;

// 提供转换后的布尔值获取方法
public Boolean getRestartableAsBoolean() {
    return restartable != null ? Boolean.valueOf(restartable) : null;
}

这种方式的缺点是字段类型变为String，需要额外处理转换，但可以快速实现校验逻辑。

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