Blog Nam Trung

n8n Schedule Trigger không chạy? Danh sách kiểm tra theo thứ tự

Workflow n8n đã bật mà Schedule Trigger không chạy hoặc chạy sai giờ. Sáu nguyên nhân hay gặp, kiểm từ dễ tới khó, theo tài liệu chính thức của n8n.

Bạn dựng xong một workflow trên n8n, bấm chạy thử thấy ổn, bật lên, rồi tới 8 giờ sáng thì chẳng có gì xảy ra. Hoặc nó chạy, nhưng chạy lúc 2 giờ chiều. Đây là một trong những câu hỏi gặp nhiều trên diễn đàn cộng đồng n8n, và điều khó chịu là một lịch chạy "chết im" không để lại lượt chạy lỗi nào để xem.

Tin tốt là phần lớn trường hợp rơi vào một trong sáu nguyên nhân dưới đây. Hãy kiểm theo đúng thứ tự: mấy bước đầu chỉ mất vài giây, mấy bước sau mới cần quyền vào máy chủ.

1. Workflow đã thật sự được publish chưa?

Schedule Trigger chỉ chạy với workflow đang hoạt động. Tài liệu n8n ghi rõ: nếu workflow dùng node Schedule làm trigger, hãy lưu và publish workflow.

Bấm Execute workflow trong trình soạn thảo chỉ là chạy thử bằng tay. Nó chứng minh các node chạy đúng, nhưng không đăng ký lịch. Các bản n8n cũ gọi bước này là "activate", bản mới gọi là "publish", nên hướng dẫn trên mạng có thể dùng chữ nào cũng có.

Kiểm tra: mở workflow, xác nhận trạng thái là đã publish/đang hoạt động, không chỉ là đã lưu.

2. Bạn có đổi khoảng thời gian sau khi publish không?

Lỗi này bắt rất nhiều người. Trang các lỗi thường gặp của n8n cho biết thay đổi khoảng thời gian của trigger sẽ chỉ có hiệu lực sau khi bạn unpublish rồi publish một phiên bản mới của workflow.

Quy tắc tương tự áp dụng cho biến dùng trong trigger: giá trị biến chỉ được đọc lúc publish. Sửa biến sau đó không làm đổi lịch chạy cho tới khi bạn dừng workflow và publish lại.

Cách sửa: unpublish rồi publish lại. Lưu ý lịch kiểu khoảng thời gian bắt đầu tính từ lúc publish, nên "mỗi 4 tiếng" nghĩa là 4 tiếng kể từ lần bấm đó, không phải từ nửa đêm.

3. Nó có chạy không, chỉ là sai giờ?

Trước khi kết luận trigger đã chết, mở danh sách Executions và xem giờ của các lượt chạy. Một workflow "không bao giờ chạy lúc 9 giờ sáng" rất hay đã chạy lúc 2 giờ chiều hoặc 3 giờ sáng.

n8n chọn múi giờ theo thứ tự: múi giờ đặt riêng trong cài đặt của workflow nếu có, nếu không thì dùng múi giờ của cả instance. Với n8n tự host, múi giờ mặc định của instance là America/New_York. Nếu bạn ở Việt Nam và chưa từng đổi, lịch của bạn lệch nhiều tiếng.

Cách sửa, chọn một:

  • Một workflow: mở menu của workflow, chọn Settings, đổi Timezone, rồi Save.
  • Cả instance tự host: đặt biến môi trường GENERIC_TIMEZONE, tài liệu n8n ghi rõ biến này quan trọng với các node lịch. Ví dụ trong Docker Compose:
environment:
  - GENERIC_TIMEZONE=Asia/Ho_Chi_Minh

Đổi biến môi trường xong thì khởi động lại container, rồi publish lại workflow.

  • n8n Cloud: đổi múi giờ của instance Cloud theo trang hướng dẫn mà tài liệu n8n dẫn tới.

4. Biểu thức cron có hợp lệ không?

Nếu dùng chế độ Custom (Cron), một lỗi gõ nhỏ có thể khiến trigger không bao giờ khớp giờ. Định dạng cron của n8n có thêm một trường giây tuỳ chọn ở đầu; tài liệu đưa ví dụ 0 6 * * * nghĩa là 6 giờ sáng mỗi ngày.

Bước kiểm tra chính thức: bỏ cột giây đi, rồi kiểm năm trường còn lại trên crontab.guru. Lỗi hay gặp là đảo vị trí trường ngày trong tháng và ngày trong tuần.

Nếu không thật sự cần cron, các chế độ có sẵn (Days, Hours, Weeks) khó sai hơn.

5. Workflow ngừng chạy sau khi triển khai hoặc nhập bằng script?

Một hiện tượng được báo trên diễn đàn: workflow triển khai hoặc nhập bằng script hiện là đang hoạt động nhưng không chạy cho tới khi có người mở ra, sửa một chút và lưu lại. Lời giải thích trong chủ đề đó là lịch được đăng ký khi có một thao tác publish thật, còn nhập thẳng vào cơ sở dữ liệu có thể bỏ qua bước này. Đây là chẩn đoán của cộng đồng, chưa phải tuyên bố chính thức, nên hãy coi là nguyên nhân có khả năng chứ chưa chắc chắn.

Cách làm nếu bạn triển khai bằng script: sau mỗi lần triển khai, unpublish rồi publish lại từng workflow có lịch qua API công khai của n8n. Tài liệu hiện tại liệt kê POST /api/v1/workflows/{id}/unpublish và POST /api/v1/workflows/{id}/publish; hai đường cũ /activate và /deactivate vẫn còn nhưng đã bị đánh dấu sắp bỏ. Xác thực bằng header X-N8N-API-KEY.

curl -X POST "$N8N_URL/api/v1/workflows/$ID/unpublish" -H "X-N8N-API-KEY: $KEY"
curl -X POST "$N8N_URL/api/v1/workflows/$ID/publish"   -H "X-N8N-API-KEY: $KEY"

Kiểm tra bản n8n của bạn hỗ trợ đường nào trước khi dựa vào cách này, vì bản cũ chỉ có activate/deactivate.

6. Chế độ queue và nhiều instance chính

Nếu chạy n8n ở chế độ queue, lịch không do các worker xử lý. Tài liệu nói instance chính lo phần hẹn giờ và webhook, tạo ra lượt chạy để worker thực hiện. Khi có nhiều instance chính, chỉ instance đang làm leader chạy các tác vụ kiểu "nhiều nhất một lần", trong đó có hẹn giờ.

Trong thực tế điều đó có nghĩa:

  • Instance chính chết hoặc không khoẻ thì không lịch nào chạy, dù worker trông vẫn ổn.
  • Container worker phải khởi động bằng n8n worker, không phải n8n start. Điểm này lấy từ một chủ đề trên diễn đàn, nơi lịch chạy trên Kubernetes tự dừng sau vài ngày.
  • Đọc log của container chính, không chỉ danh sách Executions. Trong chủ đề đó, lỗi xảy ra trước khi lượt chạy được tạo nên không hiện trong giao diện n8n; khởi động lại chỉ đỡ tạm, và lời khuyên là nâng cấp n8n. Đó là báo cáo của một người dùng và chưa có kết quả cuối, nên hãy đối chiếu với log và phiên bản của chính bạn.

Một workflow "nhịp tim" để bắt lỗi im lặng

Vì lịch chết không sinh lỗi, hãy thêm một workflow nhỏ: Schedule Trigger mỗi 15 phút ghi giờ hiện tại vào một bảng tính, một bảng dữ liệu hoặc một tệp. Nếu dòng mới nhất đã cũ, bộ hẹn giờ đã dừng, và bạn biết trước khi một việc thật bị lỡ.

Ngoài ra, đặt một Error workflow trong phần cài đặt của workflow để được báo khi những lượt chạy đã bắt đầu mà bị lỗi. Nó không bắt được trigger không bao giờ chạy, nên workflow nhịp tim vẫn cần.

Danh sách kiểm nhanh

  1. Workflow đã publish, không chỉ lưu.
  2. Đã unpublish rồi publish lại sau mỗi lần đổi khoảng thời gian hoặc biến.
  3. Đã xem giờ các lượt chạy; múi giờ của workflow hoặc instance đúng.
  4. Biểu thức cron hợp lệ (kiểm khi bỏ trường giây).
  5. Sau khi triển khai hoặc nhập bằng script, đã publish lại qua API.
  6. Ở chế độ queue: instance chính khoẻ, worker chạy bằng n8n worker, đã đọc log instance chính.

Làm hết sáu bước mà trigger vẫn không chạy, hãy đăng câu hỏi lên diễn đàn cộng đồng n8n kèm phiên bản n8n, kiểu host, cài đặt trigger chính xác và múi giờ. Đó là bốn thông tin người giúp sẽ hỏi đầu tiên.

Muốn xem một ví dụ workflow chạy theo lịch hằng ngày? Mẫu theo dõi chi tiêu cho n8n của chúng tôi dùng Schedule Trigger để gửi nhắc hạn thanh toán thẻ mỗi sáng (trang tiếng Anh).

Nguồn tham khảo