ASP.NET Core布尔值模型绑定异常：URL重复布尔值致格式错误

阿华AIGC实验室

2026-5-28

ASP.NET Core 布尔值模型绑定重复参数导致FormatException的问题分析与解决

问题原因定位

首先可以明确：这不是路由的问题，而是ASP.NET Core模型绑定器处理多值参数的逻辑导致的。

当你的ShowAll复选框被选中（值为true），切换分页时URL中出现ShowAll=true,false，本质是分页跳转时重复添加了该参数（比如分页控件生成链接时，既保留了原表单的复选框参数，又错误地追加了默认值）。而ASP.NET Core的模型绑定器在处理布尔类型的多值参数时，会将所有值拼接成一个字符串（比如"true,false"），尝试解析为布尔值时自然会抛出FormatException——因为这个拼接后的字符串不符合布尔值的格式要求。

解决办法

1. 修复分页链接的参数生成逻辑（最推荐）

问题的根源是URL中出现了重复的参数，所以优先要确保分页跳转时每个参数只出现一次。如果使用Razor视图生成分页链接，建议直接通过Url.Action传入完整的筛选模型对象，而不是手动拼接URL：

<!-- 示例：生成下一页链接 -->
<a href="@Url.Action("Index", new { 
    page = Model.page + 1, 
    SelectedBirdId = Model.SelectedBirdId, 
    ShowAll = Model.ShowAll, 
    ShowInTable = Model.ShowInTable 
})">下一页</a>

这样生成的URL会自动携带当前有效的参数值，不会出现重复的ShowAll参数。

2. 自定义布尔类型模型绑定器

如果无法避免URL中出现多值参数，可以自定义一个模型绑定器，让它在遇到多个布尔值时取第一个有效的结果：

public class BooleanMultipleValuesModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        if (bindingContext == null)
            throw new ArgumentNullException(nameof(bindingContext));

        var valueProviderResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (valueProviderResult == ValueProviderResult.None)
            return Task.CompletedTask;

        bindingContext.ModelState.SetModelValue(bindingContext.ModelName, valueProviderResult);

        // 遍历所有参数值，取第一个能解析为布尔值的结果
        foreach (var value in valueProviderResult.Values)
        {
            if (bool.TryParse(value, out bool result))
            {
                bindingContext.Result = ModelBindingResult.Success(result);
                return Task.CompletedTask;
            }
        }

        bindingContext.ModelState.TryAddModelError(bindingContext.ModelName, "无效的布尔值");
        return Task.CompletedTask;
    }
}

然后在模型的布尔属性上绑定这个自定义绑定器：

public class SortFilterIndexOptions 
{ 
    public int SelectedBirdId { get; set; } 
    [ModelBinder(BinderType = typeof(BooleanMultipleValuesModelBinder))]
    public bool ShowAll { get; set; } 
    [ModelBinder(BinderType = typeof(BooleanMultipleValuesModelBinder))]
    public bool ShowInTable { get; set; } 
    public int page { get; set; } 
}

3. 使用可空布尔类型（临时 workaround）

将布尔属性改为bool?（可空布尔类型），这样模型绑定器遇到无法解析的多值时会将属性设为null，不会直接抛出异常。之后在控制器代码中处理默认值（比如ShowAll ?? false）：

public class SortFilterIndexOptions 
{ 
    public int SelectedBirdId { get; set; } 
    public bool? ShowAll { get; set; } 
    public bool? ShowInTable { get; set; } 
    public int page { get; set; } 
}

// 在控制器中处理
public async Task<IActionResult> Index(SortFilterIndexOptions options) 
{
    var actualShowAll = options.ShowAll ?? false;
    // 后续逻辑使用actualShowAll
    ...
}