
Menambah caching dalam aplikasi ASP.NET Core memang antara cara paling cepat untuk mengurangkan beban SQL Server atau PostgreSQL dan menurunkan masa tindak balas API daripada 300ms kepada bawah 10ms. Namun, ramai pembangun hanya sedar sisi gelap caching selepas pelanggan mengadu: harga promosi RM9.90 yang sepatutnya tamat tengah malam semalam masih terpapar pagi ini, atau lebih teruk lagi—Pengguna A nampak ringkasan akaun milik Pengguna B kerana kunci cache tidak mengasingkan identiti.
Prestasi yang laju tidak bermakna apa-apa jika data yang dipaparkan kepada pelanggan adalah salah.
Kelaskan data sebelum menetapkan tempoh tamat (TTL)
Sebelum menulis satu baris kod caching, asingkan data aplikasi anda mengikut tahap toleransi terhadap kelewatan kemas kini (staleness):
- Data rujukan yang hampir statik: Senarai negeri di Malaysia, kategori produk, atau kandungan artikel blog yang jarang disunting. Data begini sesuai disimpan dalam
IMemoryCacheatauOutputCacheselama beberapa minit hingga beberapa jam. - Data yang berubah selepas tindakan pengguna: Profil pengguna, senarai tempahan, atau troli belian. Jika anda cache data ini, wajib ada mekanisme pembatalan (invalidation) serta-merta apabila rekod dikemas kini (
_cache.Remove(...)), dan kunci cache mesti menyertakan ID pengguna atau ID penyewa (tenant). - Data sensitif masa dan kewangan: Baki akaun, status pembayaran gerbang seperti FPX, atau baki stok item terakhir. Pada laluan semakan akhir transaksi (checkout), elakkan cache sama sekali—baca terus daripada pangkalan data supaya tiada kejadian jualan berganda (overselling).
Elakkan kebocoran silang pengguna dan cache stampede
Dalam dokumentasi rasmi caching ASP.NET Core, Microsoft membezakan antara IMemoryCache (memori setempat satu pelayan), IDistributedCache (seperti Redis untuk aplikasi yang berjalan di berbilang instance atau kontena), dan Output Caching.
Kesilapan paling klasik ialah membina kunci cache yang terlalu umum pada endpoint yang memulangkan data berbeza mengikut pengguna:
// SALAH: Semua pengguna berkongsi kunci yang sama
var cacheKey = "user-dashboard-summary";
// BETUL: Asingkan mengikut penyewa dan pengguna, dengan TTL yang jelas
var safeCacheKey = $"dashboard:{tenantId}:{userId}";
var summary = await _cache.GetOrCreateAsync(safeCacheKey, async entry =>
{
entry.AbsoluteExpirationRelativeToNow = TimeSpan.FromMinutes(5);
entry.SlidingExpiration = TimeSpan.FromMinutes(2);
return await _dashboardService.BuildSummaryAsync(tenantId, userId, ct);
});
Jika anda menggunakan [OutputCache] pada API atau halaman Razor yang mempunyai [Authorize], jangan main letak polisi lalai tanpa memeriksa bagaimana kunci dijana. Secara lalai, Output Cache dalam ASP.NET Core 7 ke atas tidak akan menyimpan respons yang mempunyai header Authorization atau Set-Cookie. Tetapi jika anda menulis IOutputCachePolicy tersuai untuk memintas sekatan itu tanpa mengasingkan kunci mengikut tuntutan (claims) pengguna, respons peribadi boleh terhidang kepada pelawat seterusnya.
Satu lagi masalah senyap ialah cache stampede—apabila satu kunci cache yang panas tamat tempoh pada pukul 12:00 tengah hari dan 500 permintaan serentak terus menembak pangkalan data pada milisaat yang sama. Jika projek anda masih menggunakan IMemoryCache tanpa HybridCache (.NET 9+), lindungi laluan kritikal dengan SemaphoreSlim mengikut kunci atau gunakan background refresh supaya hanya satu thread yang mengira semula nilai baharu.
Gunakan tag untuk pembatalan tersusun dan sediakan pelan insiden
Apabila admin mengubah harga satu produk di papan pemuka, anda tidak mahu menunggu 15 minit untuk TTL tamat, dan anda juga tidak mahu mengosongkan keseluruhan cache aplikasi. Dengan Output Caching di ASP.NET Core, anda boleh menandakan respons dengan tag dan membatalkannya secara khusus:
app.MapGet("/api/produk/{id:int}", async (int id, IProductRepo repo) =>
await repo.GetByIdAsync(id))
.CacheOutput(policy => policy
.Expire(TimeSpan.FromMinutes(10))
.Tag("katalog-produk"));
// Apabila admin kemas kini produk:
app.MapPost("/api/admin/produk/{id:int}", async (
int id, ProductDto dto, IProductRepo repo, IOutputCacheStore cache, CancellationToken ct) =>
{
await repo.UpdateAsync(id, dto, ct);
await cache.EvictByTagAsync("katalog-produk", ct);
return Results.NoContent();
});
Sentiasa uji senario ini di persekitaran staging sebelum naik ke production: tukar satu rekod harga sebagai admin, kemudian muat semula halaman sebagai pengguna biasa. Pastikan juga pasukan anda tahu cara membersihkan kunci tertentu dalam Redis (redis-cli DEL ... atau melalui endpoint pentadbir yang dilindungi) jika berlaku insiden data lama terperangkap ketika trafik memuncak—supaya tiada siapa terpaksa restart keseluruhan pelayan semata-mata untuk membuang satu entri cache.