如何通过注解要求布尔模型属性为false或留空并通过ModelState验证？

你遇到的问题是[Range(typeof(bool), "false", "false")]对布尔类型的验证不生效，原因是该注解在处理bool值类型时的逻辑不符合预期。以下是两种可行的解决方案：

方案一：使用自定义验证属性（值类型bool） #

如果不想修改属性的可空性，可以自定义一个验证注解，强制属性值只能为false：

public class MustBeFalseAttribute : ValidationAttribute
{
    public override bool IsValid(object value)
    {
        // 仅允许bool值为false
        return value is bool boolValue && !boolValue;
    }

    // 可选：自定义错误提示信息
    public override string FormatErrorMessage(string name)
    {
        return $"{name}必须为false或留空";
    }
}

然后在模型中应用该注解：

public class MyModel 
{
    public string StringProperty { get; set; }
    
    [MustBeFalse]
    public bool BoolProperty { get; set; }
}

• 当请求中不传递BoolProperty时，模型绑定后该属性默认值为false，验证通过；
• 传递false时验证通过；
• 传递true时验证失败，ModelState.IsValid返回false。

方案二：使用可空布尔类型+自定义验证（更清晰区分“留空”和“false”） #

如果需要明确区分“请求中未传递该属性”和“传递了false”，可以将属性改为可空布尔类型bool?，再配合自定义验证注解允许null或false：

public class FalseOrNullAttribute : ValidationAttribute
{
    public override bool IsValid(object value)
    {
        // 允许null（未传递属性）或false
        if (value == null)
            return true;
        
        return value is bool boolValue && !boolValue;
    }

    public override string FormatErrorMessage(string name)
    {
        return $"{name}必须为false或留空";
    }
}

模型修改为：

public class MyModel 
{
    public string StringProperty { get; set; }
    
    [FalseOrNull]
    public bool? BoolProperty { get; set; }
}

这种方式更贴合“留空”的语义，同时满足验证需求。

验证生效的前提 #

确保你的控制器动作中已经启用了模型验证，比如：

[HttpPost("someEndpoint")]
public IActionResult SomeAction(MyModel model)
{
    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }
    // 后续逻辑
}

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