Hoàn thành bài "Bài 5: Webhook và Tích hợp Hướng Sự kiện" trước để mở khoá bài này.Đến bài trước

Giới thiệu

Ngay cả workflow được thiết kế kỹ lưỡng nhất cũng sẽ có lúc gặp lệnh gọi API thất bại, payload sai định dạng, hoặc timeout. Trong môi trường production, những lỗi đó cần được bắt lại, ghi log và xử lý một cách trơn tru — không được nuốt lỗi âm thầm hay để toàn bộ execution bị crash. Bài học này trình bày ba trụ cột của workflow n8n đáng tin cậy: xử lý lỗi có cấu trúc, gỡ lỗi với execution log, và một checklist trước khi triển khai mà bạn có thể áp dụng cho bất kỳ tích hợp nào.

Nhánh lỗi trong n8n

n8n cung cấp hai cơ chế chính để bắt lỗi: node Error Trigger và các output lỗi theo từng node.

Node Error Trigger là một catchở cấp workflow. Bạn tạo một workflow riêng mà trigger duy nhất là node Error Trigger, sau đó trỏ workflow chính của bạn đến nó qua Settings > Error Workflow. Bất cứ khi nào bất kỳ node nào trong workflow chính ném ra một lỗi chưa được xử lý, n8n sẽ tự động khởi động error workflow và truyền vào một payload bao gồm tên workflow, node bị lỗi, thông báo lỗi và toàn bộ execution ID.

json
{
"execution": {
"id": "1042",
"url": "https://your-n8n-instance/execution/1042",
"retryOf": null,
"error": {
"message": "Request failed with status code 429",
"stack": "..."
},
"lastNodeExecuted": "HTTP Request",
"mode": "webhook"
},
"workflow": {
"id": "7",
"name": "Sync CRM Contacts"
}
}

Bên trong error workflow, bạn có thể định tuyến payload này đến Slack, PagerDuty, một node email, hoặc một row trong database — bất cứ thứ gì mà team của bạn giám sát.

Để kiểm soát chi tiết hơn, từng node riêng lẻ sẽ hiển thị một chân output phụ khi bạn bật "Continue on Fail" hoặc kích hoạt nhánh lỗi ở cấp node (khả dụng trên HTTP Request, Code, và hầu hết các node tích hợp). Kết nối chân đó tới một node phía dưới để xử lý lỗi inline mà không dừng toàn bộ workflow. Đây là pattern phù hợp khi một item bị lỗi trong một batch nên được ghi log và bỏ qua, thay vì huỷ toàn bộ.

sơ đồ flowchart thể hiện một node của workflow chính phân thành output thành công và output lỗi, trong đó nhánh lỗi được định tuyến tới một node thông báo Slack và một node ghi log vào database

Sử dụng Execution Log để truy vết lỗi

Mỗi lần thực thi n8n — thành công hay thất bại — đều được lưu trữ trong bảng Executions. Mở bất kỳ lần thực thi nào và bạn có thể kiểm tra chính xác dữ liệu đầu vào và đầu ra của từng node, giúp việc truy vết lỗi trở nên đơn giản.

Vòng lặp gỡ lỗi thực tế diễn ra như sau: chạy workflow, mở lần thực thi bị lỗi, nhấp vào node màu đỏ, đọc tab Output. Thông báo lỗi và dữ liệu đầu vào gây ra lỗi đều hiển thị ở đó. Đối với các lệnh gọi HTTP, bạn cũng sẽ thấy trạng thái response thô và body, thường cung cấp nhiều thông tin hơn so với chuỗi lỗi chung chung.

Khi bảng điều khiển tích hợp không đủ — ví dụ, khi bạn cần kiểm tra các phép biến đổi trung gian — hãy chèn một node Code tạm thời chỉ làm nhiệm vụ duy nhất là ghi log đầu vào của nó:

javascript
console.log(JSON.stringify($input.all(), null, 2));
return $input.all();

n8n hiển thị kết quả console.log bên trong chi tiết thực thi của node, để bạn có thể đọc chính xác cấu trúc dữ liệu tại thời điểm đó trong chuỗi. Hãy xóa node trước khi triển khai.

Đối với các workflow được kích hoạt bởi webhook, sử dụng nút "Listen for Test Event" để thu nhận một payload thực tế và phát lại nhiều lần trong quá trình phát triển. Điều này tránh phải kích hoạt lại hệ thống bên ngoài mỗi khi bạn lặp lại.

Áp dụng cài đặt Retry và Timeout

Các API bên ngoài thỉnh thoảng bị lỗi. Thay vì xây dựng logic retry thủ công trong node Code, hãy cấu hình nó ở cấp node. Trên bất kỳ node HTTP Request nào, mở cài đặt node và đặt Max Retries (thường là 2–3) và Retry Interval. n8n sẽ tự động back off và thử lại trên các response 5xx và lỗi mạng.

Luôn đặt một giá trị Timeout rõ ràng. Mặc định là không có timeout, nghĩa là một dịch vụ upstream bị treo sẽ chặn luồng thực thi vô thời hạn. Giá trị từ 10 000 đến 30 000 mili giây phù hợp với hầu hết các REST API.

json
{
"options": {
"timeout": 15000,
"retry": {
"maxTries": 3,
"waitBetweenTries": 2000
}
}
}

JSON này đại diện cho object options mà bạn cấu hình trong giao diện node HTTP Request — không phải thứ bạn viết thủ công, nhưng việc hiểu cấu trúc bên dưới rất hữu ích khi xuất và kiểm soát phiên bản workflow dưới dạng file JSON.

Danh sách kiểm tra trước khi triển khai

Trước khi kích hoạt bất kỳ workflow nào trên production, hãy chạy qua các bước kiểm tra sau.

Đầu tiên, thay thế tất cả các thông tin xác thực và URL được hardcode bằng n8n Credentials hoặc biến môi trường được truy cập qua object `$env`. Các bí mật không bao giờ được xuất hiện dưới dạng chuỗi thuần túy bên trong tham số của node.

Thứ hai, xác nhận rằng mọi lệnh gọi ra bên ngoài đều có thiết lập timeout và, nếu phù hợp, thiết lập retry.

Thứ ba, kết nối một Error Workflow với workflow production thông qua phần Settings. Kiểm thử bằng cách tạm thời thêm một node Code cố tình ném lỗi:

javascript
throw new Error('Test error — remove before deploy');

Xác minh rằng kênh Slack hoặc hệ thống cảnh báo của bạn nhận được thông báo, sau đó xoá node kiểm thử.

Thứ tư, rà soát lại execution mode. Các workflow được kích hoạt theo lịch hoặc qua webhook nên bật tuỳ chọn "Save Execution Progress" để tránh mất tiến trình một phần khi gặp sự cố.

Thứ năm, giới hạn những gì được lưu trữ. Nếu workflow xử lý dữ liệu cá nhân, hãy đặt "Save Data Error Execution" và "Save Data Success Execution" về "Latest only" hoặc tắt tuỳ theo chính sách lưu giữ dữ liệu của bạn.

sơ đồ flowchart checklist thể hiện 5 bước tuần tự trước khi triển khai: kiểm tra credentials, cấu hình timeout, kiểm thử error workflow, rà soát execution mode, thiết lập data retention

Tóm tắt

Các workflow n8n đạt chuẩn production kết hợp ba thói quen: định tuyến lỗi một cách tường minh bằng Error Trigger hoặc các nhánh xử lý lỗi inline thay vì để lỗi biến mất âm thầm; sử dụng panel Executions và `console.log` để kiểm tra dữ liệu tại bất kỳ điểm nào trong chuỗi; và tuân thủ một checklist trước khi triển khai một cách nhất quán, bao gồm credentials, timeout, cảnh báo và lưu giữ dữ liệu. Những thực hành này không tốn thêm nhiều thời gian ban đầu nhưng loại bỏ phần lớn việc debug mà bạn sẽ phải làm vào lúc 2 giờ sáng.

Luyện tập sau buổi học

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.

0/1
Đã trả lời · 0/1