minimal apis 是什么 asp.net core

Minimal APIs 是 ASP.net Core 6+ 的轻量级端点路由实现，绕过 mvc 管道，启动快、内存省、路径短；依赖 Webapplication.Create() 预配置服务，不支持 Startup 类、IActionResult 推荐度低，适用于简单场景，复杂需求应回归 Controller。

Minimal APIs 是 ASP.NET Core 6+ 引入的一种极简风格的 Web API 构建方式，它不依赖控制器（Controller）、不需要 Startup.cs，所有路由和逻辑直接写在 Program.cs 里，4 行代码就能跑起一个 http 服务。

它不是“简化版 MVC”，而是绕过 MVC 管道的轻量级端点路由实现——没有 Action 过滤器、没有模型绑定中间件栈、不走 ControllerBase 生命周期，因此启动更快、内存更省、请求路径更短。

为什么用 WebApplication.Create() 而不是 Host.CreateDefaultBuilder()？

因为 Minimal Hosting 模型彻底重构了宿主初始化流程：WebApplication.Create(args) 内部已预配置好路由、jsON 序列化、日志、DI 容器等必需服务，而老式 IHostBuilder 需手动调用 AddRouting()AddControllers() 等一堆方法。

• 用了 WebApplication 就不能再混用 UseMvc() 或 UseEndpoints() —— 会抛出 InvalidOperationException: Endpoint routing does not support 'IApplicationBuilder.UseMvc(...)'...
• app.MapGet() 注册的端点由 UseRouting() + UseEndpoints() 隐式启用，你不用显式调用它们
• 若项目仍保留 Startup 类，Minimal API 不会自动识别它；必须删掉或明确禁用（通过 builder.Host.ConfigureWebHostDefaults 之外的方式）

MapGet / MapPost 的参数是怎么自动绑定的？

Minimal API 使用“隐式参数绑定”机制：根据参数名、类型和上下文来源（路径、查询、Body、Header）自动匹配。但这个过程**不经过 ModelState，也没有 ValidateModel 过滤器支持**。

• app.MapGet("/user/{id}", (int id) => ...) → 自动从路由段解析 id 并转为 int；失败时返回 400 Bad Request
• app.MapPost("/user", (User user) => ...) → 自动反序列化 json Body 到 User，但 [Required] 等 DataAnnotations 不生效，除非你手动调用 Validator.TryValidateObject()
• 想显式控制来源，要用 [FromRoute] / [FromQuery] / [FromBody] 等特性（注意：这些是属性，不是类型）
• 不支持 IFormFile 直接绑定（文件上传需用 HttpContext.Request.Form 手动处理）

能用 IActionResult 吗？还是必须用 Results.*()？

可以返回 IActionResult，但**不推荐**。Minimal API 的设计哲学是“显式即安全”，所以官方提供了一组强类型的 Results.*() 工厂方法（如 Results.Ok()、Results.BadRequest()、Results.NotFound()），它们返回的是 IResult 接口实现。

• IResult 是 Minimal API 的原生响应契约，不依赖 MVC，序列化开销更低，OpenAPI 文档生成也更准确
• IActionResult 会触发兼容层适配，可能绕过某些优化（比如跳过 ProblemDetails 自动格式化）
• 如果你返回 Task，框架仍能处理，但无法利用 Results 的编译时验证和泛型推导优势
• 自定义结果？实现 IResult 接口即可，比继承 ActionResult 更轻量

var app = WebApplication.Create(args); app.MapGet("/health", () => Results.Ok(new { status = "ok", uptime = DateTimeOffset.UtcNow })); app.MapPost("/echo", (MyDto dto) =>     dto.IsValid ? Results.Ok(dto) : Results.BadRequest("Validation failed")); app.Run();

Minimal API 真正难的不是“怎么写”，而是“什么时候不该用”：一旦你需要统一异常过滤、资源级授权（[Authorize(Policy = "...")]）、多版本路由、复杂模型验证或 Action 日志装饰，就该果断退回 Controller —— 它不是银弹，只是把“简单事做极简”的工具。