Minimal APIs in ASP.NET Core：轻量级.NET后端开发新范式

Minimal APIs是ASP.NET Core 6引入的轻量级Web开发方式，无需控制器即可定义HTTP端点。通过顶级语句简化代码，适合微服务、原型验证和入门学习。示例中用几行代码注册GET接口，体现其简洁性。支持依赖注入与方法提取，可保持复杂逻辑清晰。与MVC相比，Minimal APIs牺牲部分扩展性换取开发效率，适用于小型项目或简单服务，底层仍基于相同运行时，性能相当。选择取决于项目规模与维护需求，是务实而非炫技的方案。

随着现代Web开发对效率和简洁性的要求不断提高，ASP.NET Core中的Minimal APIs应运而生，成为构建轻量级后端服务的新选择。它不是要取代传统的MVC模式，而是为那些不需要复杂架构的小型服务、微服务或原型项目提供一种更直接、更干净的开发方式。

什么是Minimal APIs？

Minimal APIs是ASP.NET Core 6引入的一项功能，允许开发者在不使用控制器（Controller）的情况下定义HTTP端点。通过精简启动模板和简化配置流程，开发者可以用几行代码快速搭建一个可运行的Web应用。

其核心特点是：无须单独的控制器类，路由与处理逻辑直接写在Program.cs中，利用顶级语句和隐式命名空间导入减少样板代码。

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => "Hello World!");
app.MapGet("/api/users/{id}", (int id) => $"User {id}");

app.Run();

这段代码创建了一个Web应用，并注册了两个GET接口，整个过程无需继承任何类或添加额外文件。

适合哪些场景？

• 微服务或边缘服务：当你的服务只负责一两项简单任务（如健康检查、配置读取），Minimal APIs能显著降低结构复杂度。
• 快速原型验证：在产品初期需要快速验证API设计时，省去控制器和视图的开销可以加快迭代速度。
• 函数式风格API：偏好将处理逻辑以委托形式表达的开发者会更适应这种“函数即接口”的写法。
• 学习入门：对于初学者来说，Minimal APIs剥离了MVC的抽象层，更容易理解请求-响应模型。

如何处理复杂逻辑？

虽然Minimal APIs强调“极简”，但并不意味着只能写内联代码。面对较复杂的业务逻辑，可以通过以下方式保持代码清晰：

Synths.Video

一键将文章转换为带有真人头像和画外音的视频

下载

• 提取方法：将处理逻辑封装成独立的方法或服务类，避免Program.cs过于臃肿。
• 依赖注入集成：依然支持通过builder.Services注册服务，并在委托中按类型注入使用。

builder.Services.AddSingleton();

app.MapGet("/todos", (ITodoService service) => service.GetAll());
app.MapPost("/todos", (ITodoService service, Todo item) =>
{
    service.Add(item);
    return Results.Created($"/todos/{item.Id}", item);
});

可以看出，即使没有控制器，也能良好地实现分层设计和服务复用。

与传统MVC对比

Minimal APIs并非全面替代MVC，两者各有定位：

• MVC更适合大型应用：具备完整的路由、过滤器、模型绑定、授权等机制，适合结构清晰、分工明确的团队协作项目。
• Minimal APIs侧重敏捷性：牺牲部分扩展性换取开发速度，在资源有限或需求简单的场景下更具优势。

值得注意的是，Minimal APIs底层仍基于相同的ASP.NET Core运行时，因此性能差异几乎可以忽略，选择更多取决于项目规模和维护成本。

基本上就这些。Minimal APIs不是炫技，而是一种务实的选择——当你不需要一艘航母时，一艘快艇可能更合适。