萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP 程式設計

8 招大幅提升 ASP.NET Web API 效能:從序列化到資料存取的全方位優化

前言

ASP.NET Web API 開發容易,但高效能需要系統性優化。本文整理 8 項經實戰驗證的效能提升技術,涵蓋序列化、資料存取、傳輸協定、非同步、快取等關鍵面向。

1. 採用最快 JSON 序列化器

JSON 序列化是 Web API 核心熱點。實測從 Newtonsoft.Json (Json.NET) 遷移至 ServiceStack.Text 可提升 ~20% 整體吞吐量。最新測試顯示 Jil(StackOverflow 採用)與 System.Text.Json(.NET Core 內建)效能更優。

序列化器相對效能備註
Jil★★★★★極致效能,功能較少
System.Text.Json★★★★☆.NET Core 3.1+ 內建,功能完整
ServiceStack.Text★★★★☆支援型別豐富
Utf8Json★★★★☆零分配設計
Newtonsoft.Json★★★☆☆功能最全,相對較慢

建議:.NET Core 專案優先 System.Text.Json;.NET Framework 專案評估 Jil 或 ServiceStack.Text。

2. 從 DataReader 手動序列化 JSON,避免中間物件建立

傳統流程:DataReader → POCO 物件 → JSON Serializer → String,涉及大量物件配置與 GC 壓力。

優化流程:DataReader → StringBuilder 直接拼接 JSON → StringContent

public HttpResponseMessage GetProducts() {
    var sb = new StringBuilder();
    sb.Append("[");
    using (var conn = new SqlConnection(connStr))
    using (var cmd = new SqlCommand("SELECT Id, Name, Price FROM Products", conn)) {
        conn.Open();
        using (var reader = cmd.ExecuteReader()) {
            bool first = true;
            while (reader.Read()) {
                if (!first) sb.Append(",");
                first = false;
                sb.Append("{");
                sb.AppendFormat("\"Id\":{0},\"Name\":\"{1}\",\"Price\":{2}", 
                    reader.GetInt32(0), 
                    reader.GetString(1).Replace("\"", "\\\""), 
                    reader.GetDecimal(2));
                sb.Append("}");
            }
        }
    }
    sb.Append("]");
    var response = Request.CreateResponse(HttpStatusCode.OK);
    response.Content = new StringContent(sb.ToString(), Encoding.UTF8, "application/json");
    return response;
}

參考:Rick Strahl's Blog 《High Performance JSON Serialization》。

3. 改用二進位協定:Protocol Buffers / MessagePack

  • 序列化速度比 JSON 快 5~10 倍。
  • 負載體積縮減 50%~80%,頻寬與序列化雙贏。
  • 適用於內部微服務通訊、高頻 API、行動裝置弱網環境。

需客戶端同步支援,公開 API 建議保留 JSON 相容。

4. 啟用 GZIP/Deflate 壓縮

回應體積縮減 70%~90%,傳輸時間大幅降低。8 行代碼實現 ActionFilter:

public class CompressAttribute : ActionFilterAttribute {
    public override void OnActionExecuted(HttpActionExecutedContext actionExecutedContext) {
        var acceptEncoding = actionExecutedContext.Request.Headers.AcceptEncoding;
        if (acceptEncoding == null) return;
        var encoding = acceptEncoding.FirstOrDefault(e => e.Value == "gzip" || e.Value == "deflate");
        if (encoding == null) return;
        actionExecutedContext.Response.Content = new CompressedContent(
            actionExecutedContext.Response.Content, encoding.Value);
    }
}

註冊:config.Filters.Add(new CompressAttribute());

5. 善用 Output Caching

對於「高頻讀取、低頻變更」的資料(如商品分類、配置資訊),加裝 [CacheOutput] 屬性或手快取:

// 手動快取範例
private static readonly MemoryCache Cache = MemoryCache.Default;
public IEnumerable GetFeatured() {
    return Cache.GetOrAdd("featured_products", () => FetchFromDb(), DateTimeOffset.Now.AddMinutes(30));
}

6. 關鍵路徑使用原生 ADO.NET,避開 ORM 開銷

ORM 便利但有代價。實測對比(單次查詢 500 筆資料):

存取方式相對耗時
手寫 ADO.NET (DataReader)1.0x (基準)
Dapper1.1x
Entity Framework Core (No Tracking)2.5x
Entity Framework 63.2x
NHibernate4.0x+

策略:核心高頻 API 使用 Dapper 或手寫 ADO.NET;複雜商務邏輯、寫入操作用 EF Core 享受開發效率。

7. 實作非同步 Action 釋放執行緒

同步 Action 佔用執行緒等待 I/O(資料庫、外部 API),限制併發。非同步可釋放執行緒處理其他請求。

[HttpGet]
public async Task GetReportAsync(int id) {
    var data = await _reportService.GenerateAsync(id); // 非同步資料庫/外部呼叫
    return Ok(data);
}

注意:全鏈路非同步(Controller → Service → Repository → ADO.NET ExecuteReaderAsync),中間不可有 .Result 或 .Wait() 同步阻塞。

8. 合併多個結果集,減少 HTTP 往返

單一 API 呼叫回傳多個關聯資料集,避免客戶端多次請求。

資料庫端:單一 Command 多結果集

using (var reader = cmd.ExecuteReader()) {
    // 第 1 結果集:供應商
    while (reader.Read()) suppliers.Add(PopulateSupplier(reader));
    // 第 2 結果集:產品
    if (reader.NextResult()) {
        while (reader.Read()) products.Add(PopulateProduct(reader));
    }
}

API 回傳聚合 DTO

public class DashboardData {
    public long MaxId { get; set; }
    public List Folders { get; set; }
    public List Users { get; set; }
}

一個請求取代三個請求,降低延遲與伺服器負載。

總結檢查清單

  1. 序列化器已升級至 Jil / System.Text.Json?
  2. 熱點 API 是否手寫 DataReader → JSON?
  3. 內部 API 是否改用 Protobuf/MessagePack?
  4. GZIP 壓縮已全域啟用?
  5. 高頻唯讀資料是否加裝 Output Cache?
  6. 核心查詢是否用 Dapper/ADO.NET?
  7. 所有 I/O 密集 Action 是否 async/await?
  8. 相關資料是否聚合回傳?

效能優化無止境,但這 8 招能解決 90% 的 Web API 效能瓶頸。

copyright © 萬盛學電腦網 all rights reserved