Minimal API中需通过注册IBinderFactory和IBinder实现自定义类型异步绑定，而非不存在的IAsyncParser；OrderRequestBinder负责异步反序列化Body，OrderRequestBinderFactory按类型匹配创建绑定器，且必须在MapMethods前注册。
Minimal API里怎么让自定义类型自动从HTTP请求绑定
Minimal API默认只支持基础类型（string、int、DateTime等）和简单POCO的模型绑定，不支持异步解析或复杂上下文依赖的参数。想让MyRequest这类类型能直接出现在路由处理器签名里（如app.MapPost("/api", (MyRequest req) => {...})），必须实现IParameterSymbol配套机制——但实际路径是注册IBinderFactory和IBinder，而非IAsyncParser（该接口并不存在于.NET标准库中，可能是混淆了旧版System.Text.Json扩展或第三方库）。
为什么不能直接实现 IAsyncParser
.NET 8 Minimal API 的参数绑定底层基于Microsoft.AspNetCore.Http.IBinder体系，不暴露IAsyncParser这样的抽象。试图搜索或实现该接口会导致编译失败或运行时忽略。真正可插拔的入口点是：
-
IBinder：负责单次请求中对某个参数执行同步/异步绑定逻辑 -
IBinderFactory：根据参数类型、元数据决定是否提供对应的IBinder - 注册方式必须通过
builder.Services.AddControllers().AddApplicationPart(...)以外的轻量方式——即调用builder.Services.AddSingleton<ibinderfactory mybinderfactory>()</ibinderfactory>
实现 IBinderFactory + IBinder 绑定自定义类型
以从JSON Body异步解析OrderRequest为例，关键点在于：工厂要识别目标类型并返回能处理它的IBinder，而IBinder内部可自由使用await（如调用外部API、DB查询、或JsonSerializer.DeserializeAsync）。
示例代码片段（精简核心）：
public class OrderRequestBinder : IBinder
{
public Task BindAsync(HttpContext context, ParameterInfo parameter)
{
if (parameter.ParameterType != typeof(OrderRequest))
return Task.CompletedTask;
// 异步读取Body并反序列化
var json = await new StreamReader(context.Request.Body).ReadToEndAsync();
var value = JsonSerializer.Deserialize<OrderRequest>(json);
context.Items[parameter.Name] = value;
return Task.CompletedTask;
}
}
public class OrderRequestBinderFactory : IBinderFactory
{
public IBinder? CreateBinder(ParameterInfo parameter)
=> parameter.ParameterType == typeof(OrderRequest) ? new OrderRequestBinder() : null;
}
注册时注意顺序：builder.Services.AddSingleton<ibinderfactory orderrequestbinderfactory>()</ibinderfactory> 必须在MapMethods之前调用，否则绑定器不会生效。
容易被忽略的兼容性细节
Minimal API绑定器不参与MVC的ModelBindingContext生命周期，因此无法复用IModelBinder或JsonConverter配置。所有解析逻辑必须自行控制：
- Body流只能读一次，
BindAsync里若未重置Request.Body.Position，后续中间件会收不到原始Body -
context.Items只是临时存储，绑定结果需通过context.RequestServices.GetRequiredService<ihttpcontextaccessor>()</ihttpcontextaccessor>等方式透出——但更推荐直接修改context.Request.RouteValues或使用context.Features.Set<t>()</t> - 若参数带
[FromQuery]或[FromHeader]等特性，IBinderFactory.CreateBinder仍会被调用，需检查parameter.GetCustomAttribute<from...attribute>()</from...attribute>来分流逻辑
真正的难点不在“怎么写异步代码”，而在“怎么让这个异步结果准确落到对应参数变量上”——Minimal API底层靠ParameterDescriptor与IBinder返回值的隐式匹配，一旦类型判断或上下文写入位置出错，就会静默回退到默认绑定（通常为null或默认值）。
