从WebApi迁移到Minimal API？有了这个神器，小白也能10分钟搞定！-优快云博客

还在纠结要不要从传统WebApi迁移到Minimal API？担心改代码改到秃头？别怕！今天给你安利一个黑科技——MiniController，让你既能享受Minimal API的轻量快速，又不用放弃WebApi的优雅写法，迁移过程比泡杯咖啡还简单！

先上链接 https://github.com/fanslead/MiniController

🧐 为啥要折腾迁移？

先给小白们科普下：传统WebApi和Minimal API就像老式电脑和轻薄本——前者功能全但笨重，后者小巧快但操作方式不一样。

场景	传统WebApi	Minimal API
代码量	一堆模板代码	一行顶过去十行
启动速度	较慢	飞快（尤其适合微服务）
项目结构	层层文件夹（Controllers、Models...）	一个Program.cs搞定大半

但直接转Minimal API又怕不习惯？MiniController就是你的过渡神器！

🚀 迁移前的准备：3步搞定环境

安装NuGet包（复制粘贴就行）：

/* by 01022.hk - online tools website : 01022.hk/zh/htmltable.html */
Install-Package MiniController
Install-Package MiniController.Attributes

（如果用.NET CLI就换这个）：

/* by 01022.hk - online tools website : 01022.hk/zh/htmltable.html */
dotnet add package MiniController
dotnet add package MiniController.Attributes

确认项目版本：需要ASP.NET Core 6.0以上（现在新建的项目基本都是啦）。

准备好你的WebApi控制器：比如这种熟悉的代码：

// 传统WebApi控制器
[ApiController]
[Route("api/[controller]")]
public class UserController : ControllerBase
{
    private readonly IUserService _userService;

    public UserController(IUserService userService)
    {
        _userService = userService;
    }

    [HttpGet("{id}")]
    public async Task<IActionResult> GetUser(int id)
    {
        var user = await _userService.GetById(id);
        return Ok(user);
    }
}

✂️ 开始迁移：改3处代码就行！

第1步：换个特性标签

把[ApiController]和[Route]删掉，换成[MiniController]：

// 原来的
[ApiController]
[Route("api/[controller]")]

// 换成这个
[MiniController("/api/[controller]")]  // 路由规则直接传参数

第2步：删掉ControllerBase继承

Minimal API不需要继承啦，直接简化：

// 原来的
public class UserController : ControllerBase

// 换成这个
public class UserController  // 去掉继承

第3步：返回值改一下（可选但推荐）

把IActionResult换成IResult，写法更简洁：

// 原来的
public async Task<IActionResult> GetUser(int id)
{
    var user = await _userService.GetById(id);
    return Ok(user);
}

// 换成这个（更清爽）
public async Task<IResult> GetUser(int id)
{
    var user = await _userService.GetById(id);
    return Results.Ok(user);  // 用Results静态类
}

🎯 注册服务：加2行代码搞定全局配置

打开Program.cs，找到var app = builder.Build();前后，加这两句：

var builder = WebApplication.CreateBuilder(args);

// 1. 注册MiniController服务（依赖注入用）
builder.Services.AddMiniControllers();

var app = builder.Build();

// 2. 注册所有端点（替代原来的MapControllers()）
app.MapMiniController();

app.Run();

搞定！就这么简单？对！因为MiniController会自动帮你生成Minimal API的路由代码，你完全不用手动写那些app.MapGet、app.MapPost了！

🧩 高级技巧：保留WebApi的好习惯

担心迁移后丢功能？不存在的！这些WebApi常用功能都支持：

依赖注入：构造函数注入照样用

public class UserController
{
    private readonly IUserService _userService;
    
    // 熟悉的构造函数注入
    public UserController(IUserService userService)
    {
        _userService = userService;
    }
}

参数绑定：[FromRoute]、[FromBody]这些标签继续用

[HttpPost]
public IResult CreateUser([FromBody] CreateUserRequest request)
{
    // 和以前一样用
}

授权和文档：[Authorize]、[ProducesResponseType]都支持

[HttpGet("{id}")]
[Authorize(Roles = "Admin")]
[ProducesResponseType(typeof(User), 200)]
[ProducesResponseType(404)]
public IResult GetUser(int id)
{
    // 权限和文档一步到位
}

❓ 常见问题：小白必看

迁移后路由变了？
不会！[MiniController("/api/[controller]")]和原来WebApi的[Route("api/[controller]")]效果一样。

静态类也能支持？
可以！简单接口直接用静态类，连依赖注入都省了（也支持方法级别的依赖注入）：

[MiniController("/api/demo")]
public static class DemoController
{
    [HttpGet("hello")]
    public static IResult Hello() => Results.Ok("Hello World");
}