
Memindahkan kerja yang lambat—seperti menjana penyata PDF ratusan baris, menghantar e-mel pengesahan melalui SMTP, atau memanggil API gerbang pembayaran pihak ketiga—ke proses latar belakang (background job) membuatkan respons API kekal pantas. Pengguna menekan butang “Hantar”, menerima status 202 Accepted dalam masa 60 milisaat, dan terus menyambung kerja lain.
Masalahnya, kerja di belakang tabir tidak mempunyai tetingkap pelayar untuk memaparkan skrin ralat merah apabila ia gagal. Jika kita tidak membina mekanisme pemantauan, log, dan pemulihan yang betul, satu tugasan penting boleh gagal secara senyap selama berhari-hari—dan kita hanya sedar apabila pelanggan menelefon bertanya mengapa invois mereka tidak pernah sampai.
Perangkap biasa BackgroundService dalam ASP.NET Core
Mengikut panduan rasmi Microsoft tentang Hosted Services, kelas BackgroundService sangat mudah didaftarkan dengan hanya satu baris builder.Services.AddHostedService<EmailWorker>(). Namun, kemudahan itulah yang sering memerangkap pembangun di produksi.
Perangkap pertama ialah pengecualian (exception) yang tidak ditangkap menghentikan worker secara senyap. Secara lalai dalam .NET moden (BackgroundServiceExceptionBehavior.StopHost), pengecualian yang terlepas keluar daripada ExecuteAsync boleh menghentikan keseluruhan host aplikasi; manakala jika dikonfigurasikan kepada Ignore, worker tersebut terus mati sambil aplikasi web utama masih kelihatan sihat dan melayani trafik! Sentiasa bungkus setiap unit kerja di dalam gelung dengan blok try / catch, rekodkan ID korelasi atau ID tugasan pada ILogger, dan bezakan antara OperationCanceledException (ketika pelayan ditutup) dengan ralat sebenar:
protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
await foreach (var jobId in _queue.Reader.ReadAllAsync(stoppingToken))
{
try
{
await ProcessJobAsync(jobId, stoppingToken);
}
catch (OperationCanceledException) when (stoppingToken.IsCancellationRequested)
{
break;
}
catch (Exception ex)
{
_logger.LogError(ex, "Gagal memproses tugasan latar {JobId}", jobId);
await MarkJobFailedAsync(jobId, ex.Message);
}
}
}
Perangkap kedua ialah bergantung kepada storan dalam memori (Channel<T>) untuk kerja yang tidak boleh hilang. System.Threading.Channels memang laju dan ringan, tetapi kesemua item di dalamnya hidup di dalam RAM. Jika anda menolak 50 tugasan penghantaran resit ke dalam Channel<T> dan sejurus itu IIS app pool membuat recycle, kontena Docker dimulakan semula, atau anda membuat deploy baharu, kesemua 50 tugasan itu lenyap tanpa jejak. Untuk kerja kritikal seperti invois, e-mel pengesahan, atau kemas kini pembayaran, simpan rekod tugasan ke dalam jadual pangkalan data (Outbox pattern) dengan lajur Status, Attempts, dan NextRetryAt sebelum memulangkan respons kepada pengguna, atau gunakan baris gilir tahan lasak seperti Hangfire, Quartz.NET, atau RabbitMQ.
Perangkap ketiga ialah retry tanpa idempotency menghasilkan kesan berganda. Bayangkan worker anda berjaya menghantar e-mel melalui pelayan SMTP, tetapi sambungan pangkalan data terputus sesaat sebelum status rekod sempat ditukar kepada Completed. Apabila sistem cuba semula (retry) tugasan itu lima minit kemudian, pelanggan menerima e-mel yang sama buat kali kedua—atau lebih teruk, sistem mengenakan caj atau mengemas kini baki stok dua kali. Pastikan setiap tugasan membawa IdempotencyKey yang unik dan semak status rekod (atau hantar kunci idempoten tersebut kepada API luaran) sebelum melaksanakan sebarang kesan sampingan.
Uji senario proses terhenti di pertengahan jalan
Sebelum melepaskan mana-mana ciri latar belakang ke produksi, buat satu ujian mudah tetapi kejam di komputer tempatan. Hantar satu tugasan yang mengambil masa lima saat untuk disiapkan, tunggu dua saat ketika worker sedang sibuk memprosesnya, dan tekan Ctrl+C (atau matikan proses secara paksa).
Kemudian hidupkan semula aplikasi dan periksa keadaan sebenar di pangkalan data: adakah tugasan itu disambung semula dengan selamat, adakah ia terperangkap dalam status Processing buat selama-lamanya tanpa timeout, atau adakah ia hilang terus? Jika anda membina jadual Outbox sendiri, sertakan mekanisme pemulihan untuk tugasan yang tersangkut dalam status Processing melebihi tempoh tertentu (misalnya lima minit) supaya pelayan yang baru hidup semula boleh mengambilnya kembali.
Kerja belakang tabir memang direka untuk tersorok daripada mata pengguna ketika semuanya berjalan lancar. Tetapi disiplin kejuruteraan di sebalik tabir itulah yang menentukan sama ada sistem anda boleh dipercayai atau hanya nampak laju di permukaan.