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<iactionresult></iactionresult>，框架仍能处理，但无法利用
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 —— 它不是银弹，只是把“简单事做极简”的工具。
