Spring Shell 3.1.6：必选Boolean参数默认值异常问题求助

是否为预期行为？ #

这是Spring Shell的预期行为。框架对boolean/Boolean类型参数有内置处理逻辑：即便标注了required = true，它仍会自动赋予默认值（基本类型boolean默认false，包装类型Boolean也默认false而非null），并且在帮助菜单里将这类参数标记为可选——因为Spring Shell默认把布尔类型参数当作可省略的开关型参数处理，而非必须显式指定的必填项。

实现需求的方法 #

方案1：用枚举替代Boolean类型（推荐） #

直接定义枚举明确区分A、B选项，从根源上规避布尔类型的默认值问题：

// 定义枚举类
public enum Choice {
    A, B
}

// 命令方法
@ShellMethod("执行选择操作")
public void select(@Option(required = true, longNames = "choice", description = "选择A或B") Choice choice) {
    if (choice == Choice.A) {
        // 执行A逻辑
    } else {
        // 执行B逻辑
    }
}

用户必须显式输入--choice A或--choice B才能执行命令，帮助菜单也会明确标注该参数为必填，完全匹配需求。

方案2：自定义参数包装类+转换器 #

如果需要保留类似布尔的逻辑，可以通过自定义类型绕开框架的默认处理：

// 自定义无默认值的布尔包装类
public class ExplicitBoolean {
    private final boolean value;

    private ExplicitBoolean(boolean value) {
        this.value = value;
    }

    public boolean getValue() {
        return value;
    }

    public static ExplicitBoolean of(boolean value) {
        return new ExplicitBoolean(value);
    }
}

// 自定义参数转换器
@Component
public class ExplicitBooleanConverter implements Converter<String, ExplicitBoolean> {
    @Override
    public ExplicitBoolean convert(String source) {
        if ("true".equalsIgnoreCase(source)) {
            return ExplicitBoolean.of(true);
        } else if ("false".equalsIgnoreCase(source)) {
            return ExplicitBoolean.of(false);
        }
        throw new IllegalArgumentException("参数必须指定为true或false");
    }
}

// 命令方法
@ShellMethod("执行布尔选择操作")
public void booleanSelect(@Option(required = true, longNames = "option", description = "指定true或false") ExplicitBoolean option) {
    boolean value = option.getValue();
    // 执行对应逻辑
}

用户必须显式输入--option true或--option false，否则会抛出参数格式错误，不会出现默认值。

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