如何禁用Spring布尔参数默认绑定规则仅允许true/false传入

问题根源是Spring MVC做请求参数绑定时，若ConversionService中的转换器转换失败，会自动回退使用Java Bean PropertyEditor 处理参数，因此仅替换转换器无法禁用默认布尔值映射规则，需要同时覆盖默认的CustomBooleanEditor。

步骤1：保留已实现的自定义转换器 #

你现有StringToBooleanConverter无需修改，保持@Component注解交给Spring托管即可。

步骤2：新增全局Spring MVC配置 #

新增配置类完成两个核心配置：移除默认的String转Boolean转换规则，全局替换Boolean类型的属性编辑器：

import org.springframework.context.annotation.Configuration;
import org.springframework.format.FormatterRegistry;
import org.springframework.web.bind.WebDataBinder;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.InitBinder;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class BooleanConvertConfig implements WebMvcConfigurer {

    private final StringToBooleanConverter stringToBooleanConverter;

    public BooleanConvertConfig(StringToBooleanConverter stringToBooleanConverter) {
        this.stringToBooleanConverter = stringToBooleanConverter;
    }

    // 替换ConversionService中的默认String->Boolean转换器
    @Override
    public void addFormatters(FormatterRegistry registry) {
        registry.removeConvertible(String.class, Boolean.class);
        registry.addConverter(stringToBooleanConverter);
    }

    // 全局覆盖默认Boolean属性编辑器，避免转换失败回退到默认逻辑
    @ControllerAdvice
    public static class GlobalBooleanEditorConfig {

        private final StringToBooleanConverter stringToBooleanConverter;

        public GlobalBooleanEditorConfig(StringToBooleanConverter stringToBooleanConverter) {
            this.stringToBooleanConverter = stringToBooleanConverter;
        }

        @InitBinder
        public void initBinder(WebDataBinder binder) {
            binder.registerCustomEditor(Boolean.class, new java.beans.PropertyEditorSupport() {
                @Override
                public void setAsText(String text) throws IllegalArgumentException {
                    setValue(stringToBooleanConverter.convert(text));
                }
            });
        }
    }
}

验证效果 #

配置完成后，所有查询参数、路径变量的布尔类型转换都会走自定义逻辑：

• 仅true/false（大小写不敏感，可自行去掉toLowerCase()调整为严格大小写）会被正常转换
• 传入0/1/on/off/yes/no等其他值时，统一抛出IllegalArgumentException

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