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 —— 它不是银弹，只是把“简单事做极简”的工具。

# js # json # app # 工具 # 栈 # ai # 路由 # .net # 为什么 # red # mvc # 中间件 # int # 继承 # 接口 # 堆 # 泛型 # http # 重构 # 绑定 # 不支持 # 序列化 # 的是 # 如果你 # 隐式 # 就能 # 不需要 # 就不 # 什么时候

返回目录在线咨询

上一篇：奖牌模板网站图片制作软件,教师光荣退休荣誉证写什么？
下一篇：android仿音悦台页面交互效果实例代码

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。

全网整合营销服务商

minimal apis 是什么 asp.net core

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

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

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

您的项目需求

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

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

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