如何实现GET参数自定义映射，将路由ID自动转换为查询到的复杂对象

你可以通过ASP.NET Core自带的自定义模型绑定能力实现该需求，完全符合你预期的用法，无需修改现有Action代码，复用查询和校验逻辑。

实现步骤 #

1. 编写ComplexObject自定义模型绑定器 #

该绑定器会自动从路由中提取ID、查询数据库、校验对象是否存在，查询失败直接返回404：

using Microsoft.AspNetCore.Mvc.ModelBinding;
using Microsoft.AspNetCore.Http;

public class ComplexObjectModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        // 从路由中获取和你模板匹配的参数值，此处和路由配置的{message}占位符对应
        var valueResult = bindingContext.ValueProvider.GetValue("message");
        if (valueResult == ValueProviderResult.None || string.IsNullOrWhiteSpace(valueResult.FirstValue))
        {
            bindingContext.Result = ModelBindingResult.Failed();
            return Task.CompletedTask;
        }

        string id = valueResult.FirstValue;
        ComplexObject obj = Database.GetById(id);
        
        // 不存在直接返回404，不会进入后续Action逻辑
        if (obj == null)
        {
            bindingContext.HttpContext.Response.StatusCode = StatusCodes.Status404NotFound;
            bindingContext.Result = ModelBindingResult.Failed();
            return Task.CompletedTask;
        }

        // 绑定成功，将对象传入Action参数
        bindingContext.Result = ModelBindingResult.Success(obj);
        return Task.CompletedTask;
    }
}

2. 注册绑定器到系统中 #

有两种注册方式，任选其一即可：

方式1：直接给实体类加绑定特性（代码量最少）

[ModelBinder(BinderType = typeof(ComplexObjectModelBinder))]
public class ComplexObject
{
    public string str1 { get; set; }
    public string str2 { get; set; }
}

方式2：全局注册绑定器（无需修改实体类）

首先实现绑定器提供者：

public class ComplexObjectModelBinderProvider : IModelBinderProvider
{
    public IModelBinder GetBinder(ModelBinderProviderContext context)
    {
        return context.Metadata.ModelType == typeof(ComplexObject) 
            ? new ComplexObjectModelBinder() 
            : null;
    }
}

然后在Program.cs中注册到控制器配置：

builder.Services.AddControllers(options =>
{
    // 放在第一位优先使用自定义绑定器
    options.ModelBinderProviders.Insert(0, new ComplexObjectModelBinderProvider());
});

3. 直接使用 #

你现有的Action代码不需要做任何修改，路由请求会自动完成ID到ComplexObject的转换，ID无效时直接返回404，不会进入Action内部。

注意事项 #

• 如果你的查询逻辑依赖注入服务（比如EF Core的DbContext、自定义仓储），不要硬编码实例，通过bindingContext.HttpContext.RequestServices.GetRequiredService<T>()获取服务实例即可
• 如果路由模板的占位符不是{message}，同步修改绑定器中GetValue()的入参和路由模板的占位符名称即可

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