ASP.NET Web API 開發容易,但高效能需要系統性優化。本文整理 8 項經實戰驗證的效能提升技術,涵蓋序列化、資料存取、傳輸協定、非同步、快取等關鍵面向。
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。
傳統流程: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》。
需客戶端同步支援,公開 API 建議保留 JSON 相容。
回應體積縮減 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());
對於「高頻讀取、低頻變更」的資料(如商品分類、配置資訊),加裝 [CacheOutput] 屬性或手快取:
// 手動快取範例
private static readonly MemoryCache Cache = MemoryCache.Default;
public IEnumerable GetFeatured() {
return Cache.GetOrAdd("featured_products", () => FetchFromDb(), DateTimeOffset.Now.AddMinutes(30));
}
ORM 便利但有代價。實測對比(單次查詢 500 筆資料):
| 存取方式 | 相對耗時 |
|---|---|
| 手寫 ADO.NET (DataReader) | 1.0x (基準) |
| Dapper | 1.1x |
| Entity Framework Core (No Tracking) | 2.5x |
| Entity Framework 6 | 3.2x |
| NHibernate | 4.0x+ |
策略:核心高頻 API 使用 Dapper 或手寫 ADO.NET;複雜商務邏輯、寫入操作用 EF Core 享受開發效率。
同步 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() 同步阻塞。
單一 API 呼叫回傳多個關聯資料集,避免客戶端多次請求。
using (var reader = cmd.ExecuteReader()) {
// 第 1 結果集:供應商
while (reader.Read()) suppliers.Add(PopulateSupplier(reader));
// 第 2 結果集:產品
if (reader.NextResult()) {
while (reader.Read()) products.Add(PopulateProduct(reader));
}
}
public class DashboardData {
public long MaxId { get; set; }
public List Folders { get; set; }
public List Users { get; set; }
}
一個請求取代三個請求,降低延遲與伺服器負載。
效能優化無止境,但這 8 招能解決 90% 的 Web API 效能瓶頸。