在 .net 8 中使用傳統的 WebAPI 專案範本

前幾天上課的時候，發現原本可以順暢使用的 LINE Bot WebHook Template (自動建立LINE Bot WebHook API專案的範本)突然間不能用了，學員哀號，身為現場指導老師，我當然跑不掉。

走向前往學員的電腦上一看，發現整個操作動作並無不妥：

dotnet new webapi
dotnet add package linebotsdk
dotnet new install isRock.Template.LineWebHook
dotnet new linewebhook

但依照過去的做法，使用瀏覽器讀取 http://localhost:???/api/LineBotChatGPTWebHook

結果出現

不對，照說透過我們 template 建立出來的 WebAPI ，其程式碼的內容應該是：

namespace isRock.Template
{
    public class LineBotChatGPTWebHookController : isRock.LineBot.LineWebHookControllerBase
    {
        [Route("api/LineBotChatGPTWebHook")]
        [HttpPost]
        public IActionResult POST()
        {
(...略...)

這段 code 所產生的 WebAPI 就算不能使用瀏覽器以 http get 方式讀取，也應該是得到 http 405 method not allowed 而非 404 啊，這怎麼回事呢?

估計應該是 Route 沒抓到，查看 Program.cs ，Routing 的設定怎麼變成底下這個樣子了?

pp.MapGet("/weatherforecast", () =>
{
    var forecast =  Enumerable.Range(1, 5).Select(index =>
        new WeatherForecast
        (
            DateOnly.FromDateTime(DateTime.Now.AddDays(index)),
            Random.Shared.Next(-20, 55),
            summaries[Random.Shared.Next(summaries.Length)]
        ))
        .ToArray();
    return forecast;
})
.WithName("GetWeatherForecast")
.WithOpenApi();

app.Run();

一問之下，果不其然。這位學員安裝了 .net 8

從 .net 8 開始，如果你使用 dotnet new webapi 這樣的 CLI 指令建立 WebAPI ，你得到的並非傳統的 Controller WebAPI ，而是 Minimal API。

WHY ???

在 .NET 8 中預設使用 Minimal API 作為 WebAPI 的範本，其主要原因是性能和原生 Ahead-of-Time (AOT) 編譯支援。如此一來，預設採用 Minimal API 的 WebAPI ，在建置階段應用程式即可通過原生 AOT 編譯獲得更小的部署大小、更快的啟動速度以及更低的記憶體使用量。此外，Minimal API 的設計強調減少程式碼配置的複雜性，使其成為構建微服務和高性能後端 API 的理想選擇​​。

簡單的說，就是配合微服務和 API 時代的來臨啦。
但 Minimal API 並非全是優點。

Minimal API 的設計注重簡單，因此缺乏傳統基於 ControllerBase 的 API 的靈活性。例如，對於 filter、authtication、可測試性…等的支援就明顯不如傳統的 WebAPI，也無法有效地處理複雜的數據類型。

因此，倘若你想在 .net 8 建立傳統的 WebAPI 也不是不行。 在 .NET 8 中，要創建一個不是 Minimal API 的傳統 Web API，你可以使用以下CLI命令：

dotnet new webapi --use-controllers 

你會發現，它又把傳統的 Controller API還給你了：

在技術更迭這麼迅速的這個時代，使用最新的技術，可能不再是最好的選擇，只有適合自己團隊和當前專案的技術，才是正解。

ref:
https://learn.microsoft.com/zh-tw/training/paths/aspnet-core-minimal-api/