Minimal API中如何实现表单字典的模型绑定？是否可行？

完全可行，Minimal API虽不支持Controllers体系的IModelBinder/IModelBinderProvider，但可通过自定义绑定逻辑实现等效的字典绑定效果，以下是两种常用实现方案：

方案一：实现IBinder接口（全局/局部绑定） #

这是适配Minimal API绑定体系的标准方式，可全局注册或针对单个端点配置：

1. 自定义字典绑定器

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

public class DictionaryModelBinder : IBinder
{
    public async Task BindAsync(BinderContext context)
    {
        var query = context.HttpContext.Request.Query;
        var dict = new Dictionary<string, string>();

        // 复用你参考的字典解析逻辑，比如处理Query参数中的键值对
        foreach (var pair in query)
        {
            dict[pair.Key] = pair.Value;
        }

        // 若需从请求Body解析，替换为Body读取逻辑：
        // var dict = await context.HttpContext.Request.ReadFromJsonAsync<Dictionary<string, string>>() ?? new();

        context.Result = ModelBindingResult.Success(dict);
    }
}

2. 注册与使用

• 全局注册（所有端点的Dictionary<string,string>都会自动使用该绑定器）：

builder.Services.Configure<MvcOptions>(options =>
{
    options.ModelBinderProviders.Insert(0, new BinderProvider<Dictionary<string, string>>(new DictionaryModelBinder()));
});

• 局部绑定（仅指定端点生效）：

app.MapGet("/api/values", ([FromQuery(BinderType = typeof(DictionaryModelBinder))] Dictionary<string, string> paramsDict) =>
{
    return Results.Ok(paramsDict);
});

方案二：静态BindAsync方法（轻量实现） #

无需全局注册，直接为目标字典类型添加静态绑定方法，Minimal API会自动识别并使用：

public static class DictionaryBindingHelper
{
    public static async ValueTask<Dictionary<string, string>> BindAsync(HttpContext context, ParameterInfo parameter)
    {
        var query = context.Request.Query;
        var dict = new Dictionary<string, string>();

        foreach (var pair in query)
        {
            dict[pair.Key] = pair.Value;
        }

        // Body解析版本：
        // return await context.Request.ReadFromJsonAsync<Dictionary<string, string>>() ?? new();

        return dict;
    }
}

使用时直接在端点参数中声明字典类型即可：

app.MapPost("/api/submit", async (Dictionary<string, string> formData) =>
{
    return Results.Ok(formData);
});

适配强类型字典 #

如果需要绑定Dictionary<string, int>这类强类型字典，只需在绑定逻辑中添加类型转换：

// 以Query绑定为例
var dict = new Dictionary<string, int>();
foreach (var pair in query)
{
    if (int.TryParse(pair.Value, out var intValue))
    {
        dict[pair.Key] = intValue;
    }
}

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