借助 async/await，我們可以在等待慢操作時，讓服務器同時處理其他任務，從而大幅提高吞吐量。

一、async/await 概念概覽

1. 同步 vs 異步

   • 同步：代碼按順序執行，遇到耗時操作就阻塞。
   • 異步：可以在等待耗時操作時，切換去執行其他代碼，讓服務器保持高效。

2. 核心關鍵詞

   • async：僅標記方法為異步，供開發者閱讀，無實際功能。
   • Task：異步方法的返回類型，用來承載執行結果。
   • await：讓方法在此處“異步掛起”，等待內部耗時操作完成后再繼續。

二、將同步方法改為異步方法

我們以 GetStocks（List 端點）為例，演示如何改造：

// 原同步方法：
// public ActionResult<IEnumerable<Stock>> GetStocks() =>
//     _context.Stocks.ToList();

// 改造后：
[HttpGet]
public async Task<ActionResult<IEnumerable<Stock>>> GetStocksAsync()
{
    var stocks = await _context.Stocks.ToListAsync();
    return stocks;
}

1. 在方法名后加上 Async 后綴并聲明 async。

2. 將返回類型改為 Task。
3. 在原來訪問數據庫的調用后添加 await，并使用 EF Core 的異步版本，如 ToListAsync()。

三、Detail 端點與其他 CRUD 操作

同樣思路，用異步版本替換同步調用：

[HttpGet("{id}")]
public async Task<ActionResult<Stock>> GetStockAsync(int id)
{
    var stock = await _context.Stocks.FindAsync(id);
    if (stock == null)
        return NotFound();
    return stock;
}

• 使用 FindAsync 而非 Find，并在前面加 await。

其他操作（POST/PUT）：

[HttpPost]
public async Task<ActionResult<Stock>> CreateStockAsync(Stock stock)
{
    _context.Stocks.Add(stock);
    await _context.SaveChangesAsync();
    return CreatedAtAction(nameof(GetStockAsync), new { id = stock.Id }, stock);
}

• 數據庫寫操作（SaveChangesAsync）也需 await。

注意 DELETE 操作：
Remove 方法本身是同步的，不要在其上使用 await，只需對 SaveChangesAsync 添加 await 即可。

四、性能驗證與測試

1. 運行項目后，使用 Swagger UI 調用異步端點。
2. 對比同步與異步調用響應時間，你會發現異步版本能明顯減輕服務器阻塞。

3. 在高并發場景下，異步模式能大幅提升吞吐量。

小結與下一步

• 理解了 async、Task 與 await 的作用及原理。
• 掌握了在 Controllers 中將同步 CRUD 方法改為異步方法的流程。
• 在實際項目中，建議優先對所有數據庫和網絡調用使用異步 API，以獲得更好的性能和可擴展性。

下一步可探索：異步流（IAsyncEnumerable）、并發限制 與 CancellationToken 等高級異步特性。祝編碼順利、高效！

原文引自YouTube視頻：https://www.youtube.com/watch?v=Ao2-wILGkPU

#你可能也喜歡這些API文章!

Python與Ollama的開發案例

FastAPI是什么？快速上手指南

使用NestJS和Prisma構建REST API：身份驗證

Amazon Lex API集成指南：打造智能對話體驗

WebSocket和REST的區別：功能、適用范圍、性能與示例解析

什么是 REST API？

DeepSeek R1 × 飛書多維表格賦能教育領域

.Net中如何創建RESTful API

18種最佳 RAG 技術