ASP.NET Core Web API：自定义属性改查询串后模型绑定未生效的解决方法

问题根源 #

你遇到的问题核心是ActionFilter的执行时机晚于模型绑定：OnActionExecutionAsync是在控制器方法执行前、但模型已经完成绑定后触发的。这时候修改Request.QueryString，已经不会影响到已经绑定好的MyMethodRequest对象了。

最优解决方案：改用资源过滤器 #

资源过滤器（ResourceFilter）的执行时机在模型绑定之前，刚好能满足你在绑定前修改查询参数的需求。只需要把你的SetupDefaultSorting从ActionFilterAttribute改成继承ResourceFilterAttribute，并重写OnResourceExecuting方法即可：

public class SetupDefaultSorting : ResourceFilterAttribute
{
    public override void OnResourceExecuting(ResourceExecutingContext context)
    {
        var queryParams = HttpUtility.ParseQueryString(context.HttpContext.Request.QueryString.ToString());
        
        // 建议增加判断：仅当sort参数不存在或为空时设置默认值
        if (string.IsNullOrWhiteSpace(queryParams["sort"]))
        {
            queryParams["sort"] = "myvalue";
        }

        context.HttpContext.Request.QueryString = new QueryString($"?{queryParams}");
    }
}

控制器上的[SetupDefaultSorting]属性无需改动，此时模型绑定会读取修改后的查询字符串，request.Sort就能正确获取到默认值。

其他可选方案 #

1. 自定义模型绑定器

如果你的默认值逻辑需要和特定模型绑定深度结合（比如多个参数联动），可以给MyMethodRequest实现自定义模型绑定器：

public class MyMethodRequestBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        // 从值提供器获取原始sort参数
        var sortValue = bindingContext.ValueProvider.GetValue("sort").FirstValue;
        
        // 设置默认值
        var request = new MyMethodRequest
        {
            Sort = string.IsNullOrWhiteSpace(sortValue) ? "myvalue" : sortValue
        };

        bindingContext.Result = ModelBindingResult.Success(request);
        return Task.CompletedTask;
    }
}

然后在模型上标记绑定器：

[ModelBinder(BinderType = typeof(MyMethodRequestBinder))]
public class MyMethodRequest
{
    public string Sort { get; set; }
}

这种方式灵活性更高，但相比资源过滤器，代码量更大，适合复杂绑定场景。

2. 直接在模型中设置默认值

如果你的默认值是全局通用的（所有使用MyMethodRequest的接口都需要这个默认值），可以直接在模型属性上初始化：

public class MyMethodRequest
{
    public string Sort { get; set; } = "myvalue";
}

注意：这种方式下，如果客户端主动传递了空字符串sort=，Sort会被设置为空，而不是默认值。如果需要强制覆盖空值，还是需要用前两种方案。

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