.NET中的Minimal API是什么？如何用它快速构建轻量级Web服务？

月夜之吻

发布时间：2025-11-14 16:18:00

805人浏览过

来源于php中文网

原创

Minimal API从.NET 6引入，通过极简语法在Program.cs中直接定义路由，无需控制器，支持依赖注入、Swagger、模型验证，适用于微服务与原型开发。

.net中的minimal api是什么？如何用它快速构建轻量级web服务？

.NET中的Minimal API 是从 .NET 6 开始引入的一种简化方式，用于快速构建轻量级、高性能的Web服务。它去除了传统 ASP.NET Core MVC 中的一些复杂结构（如控制器类、路由属性等），让你用极少的代码就能启动一个HTTP服务，特别适合构建小型API、微服务或原型项目。

Minimal API 的核心特点

• 极简语法：不需要定义控制器（Controller），直接在 Program.cs 中通过委托处理请求。
• 高性能：减少了中间抽象层，启动快，内存占用低。
• 依赖少：只加载必要的中间件和服务，适合容器化部署。
• 与 ASP.NET Core 完全兼容：仍可使用 DI、日志、认证等高级功能。

如何创建一个 Minimal API

以下是一个最简单的例子，展示如何用 Minimal API 快速搭建一个返回 JSON 的 Web 服务：

arXiv Xplorer

ArXiv 语义搜索引擎，帮您快速轻松的查找，保存和下载arXiv文章。

下载

1. 创建项目
在命令行运行：

dotnet new web -n MyMinimalApi
cd MyMinimalApi

2. 查看生成的 Program.cs
默认代码已经是最简结构：

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

app.MapGet("/", () => "Hello World!");

app.Run();

3. 添加更多路由和数据响应
你可以添加 GET、POST 等方法，并返回对象自动序列化为 JSON：

app.MapGet("/weather", () =>
{
    var forecasts = new[]
    {
        new { Date = DateTime.Now, TemperatureC = 25, Summary = "Sunny" }
    };
    return Results.Ok(forecasts);
});

app.MapPost("/users", (User user) =>
{
    // 模拟保存用户
    return Results.Created($"/users/{user.Id}", user);
});

集成常用功能

• 启用 Swagger / OpenAPI
安装 Swashbuckle.AspNetCore：

dotnet add package Swashbuckle.AspNetCore

然后在 Program.cs 中添加：

builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

// ... Build 之后
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

访问 /swagger 即可查看API文档。 • 依赖注入（DI）
注册服务并注入到处理函数中：

builder.Services.AddSingleton();

app.MapGet("/data", (IDataService service) => 
    Results.Ok(service.GetData()));

• 模型绑定与验证
Minimal API 支持自动绑定 JSON 请求体到 POCO 类型，并可通过 Validate 方法做验证：

app.MapPost("/books", (Book book) =>
{
    if (string.IsNullOrEmpty(book.Title))
        return Results.BadRequest("Title is required");

    return Results.Created($"/books/{book.Id}", book);
});

适用场景与建议

• 适合：快速原型、内部工具、微服务、无服务器函数（如 Azure Functions 风格）。
• 不适合：大型应用中需要复用逻辑、复杂权限控制或多层架构时，还是推荐使用 MVC 控制器。
• 最佳实践：将路由分组、使用单独文件组织端点、合理使用中间件。基本上就这些。Minimal API 让你几行代码就能跑起一个 Web 接口，不复杂但容易忽略细节。只要理解其“函数即路由”的思路，就能高效开发轻量服务。

C# 如何在Blazor中调用JavaScript函数 - JS互操作(JS Interop)

Blazor C# 调用 JS 的详细方法 (JS Interop)

Blazor 怎么集成图表库 (Chart.js)

Blazor 调用 JS confirm 实现删除确认的方法

Blazor 怎么调用 JavaScript 函数

相关标签:

js json app 工具路由高效开发内存占用 .net red mvc 架构中间件 json 接口委托对象 http azure

本站声明：本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系admin@php.cn

上一篇：C#的IDisposable接口是什么？如何正确实现Dispose模式？下一篇：C#的委托(Delegate)是什么？如何声明和使用委托？

作者最新文章

Rufus工具怎么用写入ISO镜像制作启动U盘的详细设置【详解】

2025-12-31 14:15

Word怎么显示段落标记 Word显示隐藏编辑标记【设置】

2025-12-31 14:17

婚礼纪Plus实物礼包怎么领婚礼纪Plus新人礼包领取地址【查询】

2025-12-31 14:26

携程旅行网页版登录入口携程网电脑登录入口

2025-12-31 14:32

Excel乘法公式怎么输入 Excel乘法公式自动计算方法【教程】

2025-12-31 15:18

系统安装后只有一个C盘怎么办无损创建D盘分区的方法【不丢数据】

2025-12-31 15:25

哔哩轻小说怎么投屏哔哩轻小说投屏到电视教程

2025-12-31 15:36

网易云音乐在线听_网易云音乐在线听网址

2025-12-31 15:44

抖音网页版官网入口_官方网站免登录网址

2025-12-31 16:53

超星学习通空间登录入口_网页版首页官方直达链接

2025-12-31 17:02

热门AI工具

DeepSeek

幻方量化公司旗下的开源大模型平台

AI大模型

开放平台

豆包大模型

字节跳动自主研发的一系列大型语言模型

AI大模型

通义千问

阿里巴巴推出的全能AI助手

AI大模型

腾讯元宝

腾讯混元平台推出的AI助手

文档处理

Excel 表格

文心一言

文心一言是百度开发的AI聊天机器人，通过对话可以生成各种形式的内容。

AI大模型

中文写作

讯飞写作

基于讯飞星火大模型的AI写作工具，可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

中文写作

写作工具

即梦AI

一站式AI创作平台，免费AI图片和视频生成。

图片拼接

图画生成

ChatGPT

最最强大的AI聊天机器人程序，ChatGPT不单是聊天机器人，还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

AI大模型

中文写作

智谱清言 - 免费全能的AI助手

AI大模型

PDF 文档

相关专题

什么是中间件

中间件是一种软件组件，充当不兼容组件之间的桥梁，提供额外服务，例如集成异构系统、提供常用服务、提高应用程序性能，以及简化应用程序开发。想了解更多中间件的相关内容，可以阅读本专题下面的文章。

175

2024.05.11

Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发，包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目，帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件，并在微服务环境中进行灵活部署与管理。

212

2025.12.18

json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章，帮助大家解决问题。

403

2023.08.07

json是什么

JSON是一种轻量级的数据交换格式，具有简洁、易读、跨平台和语言的特点，JSON数据是通过键值对的方式进行组织，其中键是字符串，值可以是字符串、数值、布尔值、数组、对象或者null，在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容，供大家免费下载体验。

528

2023.08.23

jquery怎么操作json

操作的方法有：1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”；3、“$.each(obj, callback)”；4、“$.ajax()”。更多jquery怎么操作json的详细内容，可以访问本专题下面的文章。

307

2023.10.13

go语言处理json数据方法

本专题整合了go语言中处理json数据方法，阅读专题下面的文章了解更多详细内容。

2025.09.10

硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍：1、IDE接口是一种并行接口，主要用于连接硬盘和光驱等设备，它主要有两种类型：ATA和ATAPI，IDE接口已经逐渐被SATA接口；2、SATA接口是一种串行接口，相较于IDE接口，它具有更高的传输速度、更低的功耗和更小的体积；3、SCSI接口等等。

991

2023.10.19