.NET 6 Minimal API 能否用请求类声明非Body请求参数？

.NET 6的Minimal API没有原生支持直接将自定义请求类作为路由/查询参数的绑定对象（该特性是.NET 7才引入的），但可以通过自定义绑定逻辑实现你想要的效果。

你遇到的报错原因 #

• 不给自定义类添加任何特性时，Minimal API会默认尝试从请求Body绑定参数，而GET请求本身没有Body，因此触发绑定失败报错。
• 在MapGet的委托参数上直接标注[FromRoute]时，框架会误认为要绑定名为request的路由参数，但你的路由定义里只有id，所以会报找不到对应路由参数的错误。

实现方案（两种常用方式） #

方式1：利用TryParse静态方法让框架自动绑定

给你的请求DTO类添加符合规范的TryParse静态方法，Minimal API会自动识别并通过该方法从路由中提取参数：

public class GetProductByIdRequestDto
{
    public string Id { get; set; }

    // 实现符合框架要求的TryParse方法
    public static bool TryParse(string? id, IFormatProvider? provider, out GetProductByIdRequestDto result)
    {
        result = new GetProductByIdRequestDto { Id = id ?? string.Empty };
        // 可添加参数校验逻辑
        return !string.IsNullOrEmpty(id);
    }
}

之后就可以用你期望的写法注册接口：

app.MapGet("/products/{id}", (GetProductByIdRequestDto request) => HandleRequest(request));

方式2：自定义IModelBinder和IModelBinderProvider

如果需要更复杂的绑定逻辑（比如多参数组合、自定义校验），可以通过实现模型绑定器来完成：

1. 实现模型绑定器：

public class GetProductByIdRequestDtoBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        // 从路由中获取id参数
        var idValue = bindingContext.ValueProvider.GetValue("id").FirstValue;
        
        if (string.IsNullOrEmpty(idValue))
        {
            bindingContext.ModelState.AddModelError(nameof(GetProductByIdRequestDto.Id), "Id不能为空");
            return Task.CompletedTask;
        }

        // 绑定成功，返回请求DTO实例
        bindingContext.Result = ModelBindingResult.Success(new GetProductByIdRequestDto { Id = idValue });
        return Task.CompletedTask;
    }
}

2. 实现绑定器提供者：

public class GetProductByIdRequestDtoBinderProvider : IModelBinderProvider
{
    public IModelBinder? GetBinder(ModelBinderProviderContext context)
    {
        // 当绑定类型为GetProductByIdRequestDto时，使用自定义绑定器
        if (context.Metadata.ModelType == typeof(GetProductByIdRequestDto))
        {
            return new GetProductByIdRequestDtoBinder();
        }
        return null;
    }
}

3. 在Program.cs中注册绑定器提供者：

builder.Services.AddControllers(options =>
{
    // 将自定义绑定器提供者添加到最前面，确保优先被使用
    options.ModelBinderProviders.Insert(0, new GetProductByIdRequestDtoBinderProvider());
});

4. 最后使用期望的写法注册接口即可：

app.MapGet("/products/{id}", (GetProductByIdRequestDto request) => HandleRequest(request));

补充说明 #

上述两种方式都是.NET 6下的替代方案，.NET 7中已经原生支持直接给自定义请求类的属性标注[FromRoute]/[FromQuery]等特性，并在Minimal API中直接使用该类作为参数，无需额外编写绑定逻辑。

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