Giới thiệu
Khi workflow chạy trong môi trường production, lỗi là điều không thể tránh khỏi: API bên thứ ba tạm thời không phản hồi, database trả về timeout, hoặc dữ liệu đầu vào bị thiếu trường bắt buộc. Nếu không có chiến lược xử lý lỗi rõ ràng, workflow sẽ dừng đột ngột, dữ liệu bị bỏ lơ lửng, và người vận hành không hề hay biết. Bài này giúp bạn thiết kế cơ chế để workflow vừa biết cách phản ứng khi có lỗi, vừa chủ động thông báo cho người phụ trách.
Cách n8n phân loại lỗi
n8n chia lỗi thành hai nhóm chính. Lỗi nội bộ là lỗi do chính workflow gây ra, ví dụ cú pháp biểu thức sai, tham chiếu đến biến không tồn tại, hoặc cấu hình node bị thiếu. Lỗi từ dịch vụ bên ngoài là lỗi đến từ API, database, hoặc webhook mà workflow gọi tới, ví dụ HTTP 500, timeout kết nối, hoặc rate limit. Khi một node gặp lỗi, n8n mặc định dừng toàn bộ workflow và đánh dấu execution là failed. Đây là lúc bạn cần can thiệp bằng Error Trigger để biến lỗi thành hành động có kiểm soát.
Cấu hình Error Workflow
Error Workflow là một workflow riêng biệt, bắt đầu bằng node Error Trigger, có nhiệm vụ xử lý khi workflow chính gặp lỗi. Bạn vào Settings của workflow chính, tại mục Error Workflow chọn workflow phụ mà bạn đã tạo sẵn. Trong workflow phụ, node Error Trigger tự động nhận thông tin về execution bị lỗi, bao gồm tên workflow, node gây lỗi, thông điệp lỗi, và toàn bộ input/output của node đó. Nhờ vậy bạn có đủ dữ liệu để ghi log hoặc gửi cảnh báo.
Đoạn JSON trên mô tả một workflow tối thiểu chỉ chứa node Error Trigger. Đây là điểm khởi đầu cho mọi Error Workflow. Sau node này, bạn thêm các node xử lý tuỳ ý, ví dụ gửi email, ghi vào Google Sheets, hoặc gọi Slack.
Ví dụ thực tế: gửi cảnh báo qua Slack khi workflow lỗi
Giả sử bạn có workflow chính tên "Đồng bộ đơn hàng" đang chạy mỗi 15 phút, gọi API của sàn thương mại điện tử. Khi API trả về lỗi 500, bạn muốn nhận thông báo ngay trong kênh Slack để kịp thời xử lý. Bạn tạo workflow phụ với Error Trigger, tiếp theo là node Set để định dạng nội dung tin nhắn, rồi node Slack gửi vào kênh #alerts.
Đoạn code trên lấy tên workflow, tên node gây lỗi và thông điệp lỗi từ Error Trigger, sau đó gói thành object để node Slack sử dụng. Bạn có thể mở rộng bằng cách thêm node IF kiểm tra mức độ nghiêm trọng, hoặc node Google Sheets để ghi lịch sử lỗi phục vụ phân tích sau.
Retry và chiến lược phục hồi
Với lỗi tạm thời từ dịch vụ bên ngoài, bạn không nên bỏ cuộc ngay lập tức. Trong phần Settings của mỗi node HTTP Request hoặc database node, n8n cho phép bật Retry on Fail với số lần thử lại và khoảng cách giữa các lần thử. Chiến lược hợp lý là thử lại 3 lần, mỗi lần cách nhau 5 giây, sau đó mới chuyển lỗi sang Error Workflow. Kết hợp retry với Error Trigger, bạn có hai lớp bảo vệ: lớp một tự phục hồi với lỗi nhẹ, lớp hai thông báo con người khi lỗi thực sự nghiêm trọng.
Tổng kết
Error Trigger và Error Workflow là cặp công cụ cốt lõi để bạn xây dựng workflow có khả năng chống chịu lỗi. Bằng cách phân loại lỗi, cấu hình Error Workflow, bật retry hợp lý, và gửi cảnh báo tới kênh giao tiếp của team, bạn biến workflow từ một chuỗi thao tác dễ vỡ thành hệ thống đáng tin cậy. Trong bài tiếp theo, bạn sẽ học cách kết hợp logic phân nhánh với xử lý lỗi để tạo workflow thích ứng với nhiều tình huống dữ liệu khác nhau.
Bài kiểm tra cuối bài
Ôn lại kiến thức, thử sức và nhận góp ý cho bài làm.