minimal api 参数绑定默认按类型和位置自动推断来源：简单类型从路由或查询字符串绑定，复杂类型仅支持application/json请求体；get等方法禁用请求体绑定，httprequest/httpresponse参数会禁用其他自动绑定。
Minimal API 的参数绑定不是靠加 [FromQuery] 或 [FromBody] 特性生效的——它默认就按类型和位置自动推断来源。写错类型或发错格式，400 就直接来了，连日志都不多打一行。
简单类型（string、int、Guid）怎么绑才不丢值
这类参数默认从路由段或查询字符串取值，不查请求体。比如 app.MapGet("/user/{id}", (int id) => ...) 中的 id，必须出现在路径里；而 app.MapGet("/search", (string q, int page) => ...) 的 q 和 page 则来自 ?q=abc&page=2。
- 如果路径里写了
{id}但参数类型是string，也能匹配，但若实际传的是非数字（如/user/abc），会 404（路由不匹配），不是 400 -
DateTime、bool、decimal也属于“简单类型”，同样走 query/route，不支持 ISO 格式自动解析？别信——.NET 8 默认支持yyyy-MM-dd和yyyy-MM-ddTHH:mm:ss，但时区偏移（如+08:00）需显式配置JsonSerializerOptions - 想强制从 header 取值？得用
[FromHeader(Name = "X-Trace-ID")] string traceId，否则类型再对也没用
复杂类型（如 UserDto）为什么一发表单就 400
因为 Minimal API 默认只接受 application/json 请求体来反序列化复杂类型。前端用 FormData 或 axios.post(url, { a: 1 })（没设 Content-Type）发过来的其实是 application/x-www-form-urlencoded，框架直接拒收，返回 400 —— 不报错原因，也不进你的 handler。
- 解决方法只有两个：前端改发 JSON（加
headers: { 'Content-Type': 'application/json' }），或后端手动读取表单：await context.Request.ReadFormAsync() - 不能在参数上加
[FromForm]—— Minimal API 不识别 MVC 特性，加了等于没加 - 如果真要支持表单自动绑定，得实现
IBinder+IBinderFactory，注册到builder.Services，成本远高于改前端
HttpRequest 和 HttpResponse 参数怎么用才不踩坑
它们是底层上下文对象，不参与自动绑定，而是直接注入。但要注意：一旦你在 handler 里用了 HttpRequest，所有其他参数就**不再自动绑定**，必须手动从 context.Request 里取。
- 错误写法：
app.MapPost("/login", (HttpRequest req, UserDto user) => ...)——user不会自动解析，req后面的参数全失效 - 正确写法：只留
HttpRequest，然后自己调req.ReadFromJsonAsync<userdto>()</userdto>或req.Form -
HttpResponse同理，且它不能和IResult（如Results.Ok()）混用，二者互斥
GET 方法能从 body 绑定吗？
不能，默认禁止。Minimal API 明确规定：GET、HEAD、OPTIONS、DELETE 不从请求体隐式绑定任何参数。这是 HTTP 语义决定的，不是 bug。
- 如果你非要从 GET 的 body 读数据（比如调试用），只能显式操作：
app.MapGet("/debug", async (HttpContext ctx) => { var json = await new StreamReader(ctx.Request.Body).ReadToEndAsync(); ... }) - 别指望
(UserDto data)在 GET handler 里自动工作，哪怕加了[FromBody]也无效 - 真正该做的是：把本该放 body 的数据，改成 query 参数或路径参数
最常被忽略的一点：绑定规则不是“全局开关”，而是每个 endpoint 独立决策的。同一个 UserDto 类，在 MapPost 里自动从 JSON 绑，在 MapGet 里连声明都会被跳过——不是框架忘了，是它根本没打算支持。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
