Quartz.NET vs Coravel: Lựa Chọn Nào Cho Lập Lịch Tác Vụ Trong .NET? – Trên Chặng Đường Lộ Trình .NET

Mọi ứng dụng .NET có tuổi thọ vài tháng đều sinh ra một danh sách job: gửi báo cáo lúc 7 giờ, đồng bộ dữ liệu mỗi 15 phút, dọn bản ghi hết hạn mỗi đêm. Câu hỏi không phải “dùng Quartz.NET hay Coravel” mà là “job của bạn có được phép mất khi pod restart không”. Bài này so sánh Quartz.NET và Coravel dựa trên đúng câu hỏi đó, kèm Hangfire và BackgroundService để bạn không chọn sai công cụ.

Cập nhật 2026

  • Quartz 4.7.2 đã bỏ nhiều API 3.x; cách đăng ký qua AddQuartz + AddJob<T> là chuẩn hiện tại, không cần tự dựng scheduler bằng tay.
  • Coravel 6.0.2 vẫn là scheduler in-process: không persistence, không clustering — đây là đặc điểm thiết kế, không phải thiếu sót.
  • Hangfire 1.8.25 là lựa chọn rẻ nhất cho persistent job có dashboard; nhiều server dùng chung SQL storage là tính năng của bản OSS, không cần Pro.
  • .NET 10 có PeriodicTimer và hosted service ổn định, đủ cho vài job nội bộ — nhưng không thay thế scheduler khi cần lịch theo giờ hoặc chạy lại sau restart.

Vì sao Timer không đủ

Một vòng lặp while (true) { await Task.Delay(...) } có ba vấn đề cố định: nó trôi theo thời gian (mỗi lần chạy cộng thêm thời gian xử lý), nó không biết “7 giờ sáng theo múi giờ nào”, và khi process chết thì lịch chết cùng. Scheduler giải quyết cả ba, nhưng mỗi scheduler giải quyết ở mức khác nhau. Đó là lý do phải đọc kỹ mô hình lưu trữ của từng thư viện trước khi chọn.

Quartz.NET 4.7.2: job, trigger, job store

Quartz mô hình hoá lịch thành ba khái niệm tách biệt. IJob là việc cần làm. ITrigger là khi nào làm — cron, simple interval, calendar. IScheduler là engine ghép hai thứ đó và chạy chúng. Việc tách này cho phép một job gắn nhiều trigger, hoặc đổi trigger mà không sửa job.

// File: src/Jobs/SendDailyReportJob.cs
public sealed class SendDailyReportJob(IReportService reports, ILogger<SendDailyReportJob> logger) : IJob
{
    public async Task Execute(IJobExecutionContext context)
    {
        var ct = context.CancellationToken;
        var target = DateOnly.FromDateTime(DateTime.UtcNow.AddDays(-1));
        logger.LogInformation("Gửi báo cáo cho ngày {Date}", target);

        // Job phải idempotent: chạy lại cùng ngày không được tạo báo cáo thứ hai.
        await reports.SendOnceAsync(target, ct);
    }
}

Đăng ký trong ASP.NET Core 10:

// File: src/Program.cs
var tz = TimeZoneInfo.FindSystemTimeZoneById("Asia/Ho_Chi_Minh");

builder.Services.AddQuartz(q =>
{
    var jobKey = new JobKey("send-daily-report", "reports");

    q.AddJob<SendDailyReportJob>(opts => opts.WithIdentity(jobKey).StoreDurably());

    q.AddTrigger(opts => opts
        .ForJob(jobKey)
        .WithIdentity("send-daily-report-trigger")
        .WithCronSchedule("0 0 7 * * ?", cron => cron
            .InTimeZone(tz)
            .WithMisfireHandlingInstructionDoNothing()));
});

builder.Services.AddQuartzHostedService(o => o.WaitForJobsToComplete = true);

Ba dòng đáng chú ý: InTimeZone gắn lịch với múi giờ nghiệp vụ thay vì UTC của server; StoreDurably() giữ job trong store dù không có trigger nào trỏ tới; và WaitForJobsToComplete cho phép job đang chạy hoàn tất khi shutdown — nhưng chỉ trong giới hạn thời gian mà orchestrator cho phép.

Misfire: chuyện chỉ lộ ra khi có sự cố

Misfire là trigger đã đến giờ nhưng scheduler không chạy được (process chết, cluster đang failover, job trước còn kẹt). Quartz buộc bạn chọn chính sách:

  • WithMisfireHandlingInstructionDoNothing(): bỏ lần lỡ, chờ kỳ tiếp theo. Đúng cho báo cáo, email marketing.
  • WithMisfireHandlingInstructionFireAndProceed(): chạy bù một lần ngay, rồi tiếp tục lịch. Đúng cho job tích luỹ như đồng bộ dữ liệu.
  • WithMisfireHandlingInstructionIgnoreMisfiredExecutions(): chạy bù mọi lần đã lỡ. Hiếm khi đúng — dễ tạo bão job sau khi scheduler downtime dài.

Mặc định của cron trigger là “fire and proceed”, thường không phải điều bạn muốn. Hãy đặt tường minh cho từng job.

ADO job store và clustering

q.UsePersistentStore(store =>
{
    store.UseProperties = true;
    store.UseSqlServer(builder.Configuration.GetConnectionString("Quartz")!);
    store.UseClustering(c => c.CheckinInterval = TimeSpan.FromSeconds(10));
});

Điều kiện để clustering chạy đúng: mọi instance trỏ cùng database, schema Quartz đã được tạo bằng script SQL đi kèm package, và mỗi instance có instanceId duy nhất (đặt AUTO để Quartz tự sinh). Nếu hai pod dùng cùng instance id, chúng sẽ tranh nhau trigger và bạn sẽ thấy job chạy trùng ngẫu nhiên — một lỗi rất khó truy.

Cần nói rõ: job store chính thức của Quartz là ADO (SQL Server, PostgreSQL, MySQL, Oracle, SQLite). Không có Redis job store first-party; nếu tài liệu bạn đọc nói khác, đó là plugin bên thứ ba.

Quartz 4.x khác 3.x ở đâu

Nếu bạn copy code Quartz từ tài liệu 2022, ba lỗi thường gặp nhất: q.UseMicrosoftDependencyInjectionJobFactory() không còn tồn tại (job factory mặc định đã giải quyết dependency qua DI khi dùng AddQuartz), nhiều overload đồng bộ của IScheduler đã bị gỡ để buộc dùng async, và một số API “cấu hình bằng property” đã chuyển sang builder. Cách an toàn là bám theo mẫu AddQuartz + AddJob<T> + AddTrigger như trên, vì đó là bề mặt API được duy trì qua cả 3.x và 4.x. Nếu bạn tự dựng StdSchedulerFactory cho console app, hãy dùng await factory.GetScheduler() và nhớ rằng StdSchedulerFactory đọc cấu hình từ quartz.properties hoặc NameValueCollection — không có DI container phía sau, nên job phải tự lấy service qua context.SchedulerContext hoặc một service locator.

Coravel 6.0.2: in-process, không persistence

Coravel nhỏ hơn một bậc về khái niệm: bạn viết IInvocable, khai báo lịch bằng fluent API, và Coravel gọi nó trong tiến trình của bạn. Không bảng trong database, không cluster coordination.

// File: src/Jobs/SendDailyReportInvocable.cs
public sealed class SendDailyReportInvocable(IReportService reports) : IInvocable
{
    public async Task Invoke()
    {
        var target = DateOnly.FromDateTime(DateTime.UtcNow.AddDays(-1));
        await reports.SendOnceAsync(target, CancellationToken.None);
    }
}
// File: src/Program.cs
builder.Services.AddCoravel();

var app = builder.Build();

app.UseScheduler(scheduler =>
{
    var tz = TimeZoneInfo.FindSystemTimeZoneById("Asia/Ho_Chi_Minh");

    scheduler.Schedule<SendDailyReportInvocable>()
        .DailyAt(7, 0)
        .Zoned(tz)
        .PreventOverlapping();

    scheduler.Schedule<SyncCatalogInvocable>()
        .EveryFifteenMinutes()
        .PreventOverlapping();
});

app.Run();

PreventOverlapping() chỉ có tác dụng trong một process. Trên hai pod, cả hai sẽ chạy job cùng lúc — Coravel không biết pod kia tồn tại. Đây là giới hạn cần chấp nhận hoặc bù bằng distributed lock.

Cron của Coravel dùng cú pháp 5 trường chuẩn (phút giờ ngày tháng thứ), không có trường giây và năm như Quartz. Với hầu hết nhu cầu “mỗi ngày lúc 7 giờ”, khác biệt này không quan trọng; với “thứ Hai đầu tiên của tháng” thì nên dùng Quartz.

Hangfire 1.8.25: khi bạn cần dashboard và persistence ngay

Hangfire nằm giữa hai lựa chọn trên: job lưu trong SQL/Redis, có dashboard xem được job nào fail, retry được bằng tay, và scale-out bằng cách thêm server cùng trỏ một storage.

// File: src/Program.cs
builder.Services.AddHangfire(cfg => cfg
    .SetDataCompatibilityLevel(CompatibilityLevel.Version_180)
    .UseSimpleAssemblyNameTypeSerializer()
    .UseRecommendedSerializerSettings()
    .UseSqlServerStorage(builder.Configuration.GetConnectionString("Hangfire")!));

builder.Services.AddHangfireServer(o => o.WorkerCount = 4);

var app = builder.Build();
app.UseHangfireDashboard("/hangfire");
// Lịch định kỳ, có time zone riêng
RecurringJob.AddOrUpdate<SendDailyReportJob>(
    "send-daily-report",
    job => job.RunAsync(CancellationToken.None),
    "0 7 * * *",
    new RecurringJobOptions
    {
        TimeZone = TimeZoneInfo.FindSystemTimeZoneById("Asia/Ho_Chi_Minh")
    });

Hai điểm so với bài viết cũ: RecurringJobOptions.TimeZone nhận TimeZoneInfo (không phải chuỗi TimeZoneId như 1.7), và clustering không phải tính năng Pro. Nhiều server Hangfire dùng chung storage đã phân phối job; bản Pro thêm batch, continuation, queue động — không phải khả năng chạy nhiều instance.

BackgroundService khác scheduler ở đâu

// File: src/Workers/OutboxPump.cs
public sealed class OutboxPump(IServiceScopeFactory scopes, ILogger<OutboxPump> logger) : BackgroundService
{
    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        using var timer = new PeriodicTimer(TimeSpan.FromSeconds(5));
        while (await timer.WaitForNextTickAsync(stoppingToken))
        {
            await using var scope = scopes.CreateAsyncScope();
            var outbox = scope.ServiceProvider.GetRequiredService<IOutbox>();
            await outbox.PublishPendingAsync(stoppingToken);
        }
    }
}

Đây là công cụ đúng cho “chạy liên tục, mỗi 5 giây kiểm tra một hàng đợi” — outbox pump, consumer, health probe. Nó sai khi bạn cần “chạy lúc 7 giờ sáng” hoặc “không mất lịch khi restart”. BackgroundService không có khái niệm trigger, không có lịch sử lần chạy, không có misfire. Dùng nó thay scheduler là nguồn gốc của những job chạy 2 giờ sáng vì pod restart đúng lúc.

Bốn thứ thư viện không giải quyết cho bạn

Idempotency

Mọi scheduler đều có thể chạy job hai lần: failover cluster, retry sau lỗi, người vận hành bấm “run now”. Job của bạn phải chịu được điều đó. Cách bền nhất là đặt khoá nghiệp vụ (report_date + tenant_id) và unique index ở tầng database, để lần chạy thứ hai thất bại nhanh thay vì gửi trùng email.

Distributed lock

Khi nhiều instance cùng chạy một job, “chỉ một instance làm việc” là bài toán lock, không phải bài toán scheduler. Dùng IDistributedLock từ Medallion.Threading (SQL Server, PostgreSQL, Redis provider) hoặc RedLock.net. Lưu ý: lock trên một node Redis đơn lẻ không an toàn khi cần consensus; Redlock có tranh cãi về tính đúng đắn dưới partition — đừng dùng nó cho giao dịch tài chính.

Time zone

Lưu mọi timestamp trong database bằng UTC, nhưng khai báo lịch bằng múi giờ nghiệp vụ. Container thường thiếu tzdata: nếu FindSystemTimeZoneById("Asia/Ho_Chi_Minh") ném lỗi trên image distroless, đó là lỗi môi trường chứ không phải lỗi code. Và nhớ rằng “7 giờ sáng” ở múi giờ có DST sẽ lệch một giờ vào mùa hè — với Việt Nam (UTC+7, không DST) điều này không xảy ra, với khách hàng châu Âu thì có.

Graceful shutdown

Kubernetes gửi SIGTERM rồi chờ terminationGracePeriodSeconds (mặc định 30 giây). Quartz với WaitForJobsToComplete = true và Hangfire với stop timeout hợp lý sẽ cố hoàn tất job đang chạy; Coravel sẽ cắt job giữa chừng. Job bị cắt phải an toàn khi chạy lại — quay về idempotency.

Bảng quyết định

Nhu cầu của bạn Chọn Vì sao
Job in-process, vài lịch cố định, một instance, mất lịch khi restart không sao Coravel 6.0.2 Ít ceremony nhất, API đọc như tiếng Anh
Cần lịch tồn tại qua restart, nhiều instance, cron phức tạp Quartz 4.7.2 + ADO store Clustering và misfire policy ở tầng engine
Cần persistence + dashboard + retry thủ công, không muốn viết nhiều hạ tầng Hangfire 1.8.25 Storage sẵn, UI vận hành sẵn
Vòng lặp nền liên tục (outbox, consumer, polling) BackgroundService Không cần lịch, chỉ cần vòng đời gắn với app

Nếu job phải chạy đúng giờ ở quy mô lớn và bạn đã có Kubernetes, một lựa chọn khác đáng cân nhắc là CronJob của K8s hoặc Azure Functions Timer Trigger — hạ tầng chạy lịch, code của bạn chỉ là một endpoint idempotent. Đổi lại bạn mất khả năng quan sát tập trung trong app.

Nhìn tới 2027

.NET 11 GA vào tháng 11/2026 (STS, hỗ trợ khoảng hai năm), .NET 12 LTS tháng 11/2027. Với scheduler, thay đổi đáng chú ý không đến từ runtime mà từ hạ tầng: orchestration bằng Aspire/Dapr phổ biến hơn, và job ngày càng được viết như endpoint idempotent để chạy trên nền tảng serverless thay vì nhúng scheduler vào web app. Quartz 4.x vẫn sẽ là lựa chọn enterprise; Coravel vẫn đúng cho service nhỏ.

Checklist trước khi thêm scheduler

  • Viết ra ba câu: job làm gì, chạy khi nào theo múi giờ nào, và chạy lại hai lần có sao không.
  • Nếu “chạy lại hai lần có sao” — sửa job trước, chọn thư viện sau.
  • Đếm số instance bạn sẽ chạy trong 12 tháng tới; nếu nhiều hơn một, cần store dùng chung hoặc lock.
  • Đặt misfire policy tường minh, đừng dựa vào mặc định.
  • Kiểm tra terminationGracePeriodSeconds của orchestrator có khớp thời gian job dài nhất không.

Đọc tiếp trong series: