如何使用.NET 6 Minimal API快速搭建轻量级Web服务

Minimal API是.NET 6引入的轻量级Web API开发方案，它去掉了传统MVC模式中控制器的冗余结构，通过极简的代码就能完成HTTP服务的搭建，非常适合开发小型微服务、工具类接口等场景。下面我们一步步学习它的使用方法。

创建Minimal API项目

首先打开命令行工具，执行以下命令创建Minimal API项目：

dotnet new web -n MinimalApiDemo
cd MinimalApiDemo

项目创建完成后，打开Program.cs文件，你会看到默认的代码已经非常简洁，核心逻辑都在这里完成。

基础路由与请求处理

Minimal API通过MapGet、MapPost等方法定义路由，下面的代码演示了基础的GET和POST接口：

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

// 基础GET接口，返回字符串
app.MapGet("/", () => "Hello Minimal API");

// 带路径参数的GET接口
app.MapGet("/user/{id}", (int id) => $"用户ID是：{id}");

// POST接口，接收请求体参数
app.MapPost("/user", (User user) => $"接收到用户：{user.Name}，年龄：{user.Age}");

app.Run();

// 定义用户实体类
public record User(string Name, int Age);

参数绑定与验证

Minimal API支持自动绑定查询参数、路径参数、请求体参数，也可以添加参数验证规则：

// 绑定查询参数
app.MapGet("/search", (string keyword, int page = 1) => 
    $"搜索关键词：{keyword}，页码：{page}");

// 带参数验证的接口
app.MapPost("/product", (Product product) => 
{
    if (string.IsNullOrEmpty(product.Name))
    {
        return Results.BadRequest("产品名称不能为空");
    }
    return Results.Ok($"产品{product.Name}添加成功");
});

public record Product(string Name, decimal Price);

依赖注入使用

Minimal API完全支持.NET的依赖注入机制，我们可以注册服务并在接口中直接使用：

// 注册服务
builder.Services.AddSingleton<IUserService, UserService>();

var app = builder.Build();

// 在接口中注入服务
app.MapGet("/users", (IUserService userService) => 
{
    var users = userService.GetAllUsers();
    return Results.Ok(users);
});

// 定义服务接口和实现
public interface IUserService
{
    List<string> GetAllUsers();
}

public class UserService : IUserService
{
    public List<string> GetAllUsers()
    {
        return new List<string> { "张三", "李四", "王五" };
    }
}

中间件与异常处理

我们可以在Minimal API中使用传统的中间件，也可以添加全局异常处理：

// 添加全局异常处理中间件
app.Use(async (context, next) =>
{
    try
    {
        await next();
    }
    catch (Exception ex)
    {
        context.Response.StatusCode = 500;
        await context.Response.WriteAsync($"服务异常：{ex.Message}");
    }
});

// 自定义中间件
app.Use(async (context, next) =>
{
    context.Response.Headers.Add("X-Custom-Header", "MinimalApiDemo");
    await next();
});

运行与测试

完成代码编写后，执行以下命令启动项目：

dotnet run

启动后可以通过浏览器或者Postman访问对应的接口地址，测试接口是否正常返回数据。如果需要部署到生产环境，也可以像传统.NET项目一样发布到IIS、Docker等载体中。

Minimal_API.NET_6Web_API路由配置依赖注入修改时间：2026-06-16 07:30:13