如何改进ASP.NET Core自定义模型绑定器以动态绑定所有路由参数？

要实现动态绑定所有路由参数到模型，核心思路是遍历当前路由中的所有参数，通过反射将参数值匹配并赋值给模型的对应属性，替代原来只固定处理id的逻辑。以下是完整实现：

1. 通用自定义模型绑定器 #

替换原有的BaseIdRequestModelBinder，改成适配任意模型的通用绑定器：

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

        var modelType = bindingContext.ModelType;
        var modelInstance = Activator.CreateInstance(modelType);
        var properties = modelType.GetProperties(BindingFlags.Public | BindingFlags.Instance);

        // 遍历所有路由参数
        foreach (var routeParam in bindingContext.ActionContext.RouteData.Values)
        {
            var paramName = routeParam.Key;
            var paramValue = routeParam.Value?.ToString();

            // 找到模型中名称匹配的属性（大小写不敏感）
            var property = properties.FirstOrDefault(p => p.Name.Equals(paramName, StringComparison.OrdinalIgnoreCase));
            if (property == null || !property.CanWrite)
                continue;

            // 尝试转换参数值到属性类型
            try
            {
                var convertedValue = Convert.ChangeType(paramValue, property.PropertyType);
                property.SetValue(modelInstance, convertedValue);
            }
            catch
            {
                // 转换失败时标记绑定失败，也可根据需求忽略错误继续绑定其他参数
                bindingContext.Result = ModelBindingResult.Failed();
                return Task.CompletedTask;
            }
        }

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

2. 对应的自定义特性 #

修改原特性，指向新的绑定器：

public class FromDynamicRouteAttribute : ModelBinderAttribute
{
    public FromDynamicRouteAttribute() : base(typeof(DynamicRouteModelBinder))
    {
    }
}

3. 示例使用 #

根据路由定义匹配对应的模型，直接在接口中使用特性即可：

示例1：包含多参数的路由 #

模型类：

public class UserRequest
{
    public long Id { get; set; }
    public string Name { get; set; }
}

接口：

[HttpGet("api/[controller]/[action]/{id:long}/{name}")]
public ActionResult GetUser([FromDynamicRoute] UserRequest request)
{
    // 直接使用request.Id和request.Name
    return Ok(new { Id = request.Id, Name = request.Name });
}

示例2：仅含id的路由 #

模型类：

public class BaseIdRequest
{
    public long Id { get; set; }
}

接口：

[HttpGet("api/[controller]/{id:long}")]
public ActionResult GetItem([FromDynamicRoute] BaseIdRequest request)
{
    return Ok(new { Id = request.Id });
}

注意事项 #

• 模型属性名称与路由参数名称大小写不敏感匹配，若需自定义映射关系，可扩展绑定器添加特性标记（如[RouteParam("paramName")]）处理别名。
• 参数类型转换失败时，当前实现直接标记绑定失败，可根据业务需求调整逻辑：比如忽略转换失败的参数，或把错误信息添加到bindingContext.ModelState中。
• 若需支持查询参数的动态绑定，可扩展逻辑，同时遍历bindingContext.HttpContext.Request.Query中的参数。

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