Xử lý lỗi trong n8n: Retry, Error Workflow và cảnh báo

Sáng thứ Hai, sếp hỏi: “Sao tuần này không thấy email báo cáo?”. Mở n8n ra mới biết workflow đã lỗi từ 8 giờ 30 vì Google Sheets trả về lỗi quá tải, và không ai được báo. Tự động hóa chỉ đáng tin khi nó biết tự thử lại với lỗi tạm thời và lên tiếng ngay khi thật sự hỏng. Bài viết này hướng dẫn xử lý lỗi n8n theo ba lớp: Retry On Fail, thiết lập On Error và Error Workflow gửi cảnh báo qua Telegram, kèm code mẫu đã chạy thử.

🩺 MỤC TIÊU SAU BÀI VIẾT

✅ Chạy tốt🔁 Lỗi tạm thời → tự thử lại🚨 Hỏng thật → báo Telegram ngay

📂 NỘI DUNG BÀI VIẾT

1. Vì sao workflow chạy hỏng?
2. Ba lớp xử lý lỗi trong n8n
3. Xây Error Workflow cảnh báo qua Telegram
4. Checklist xử lý lỗi trước khi đưa workflow vào chạy thật
5. Mẹo từ thực tế
6. Câu hỏi thường gặp
7. Kết luận

🛡 LỖI ĐI QUA TỪNG LỚP, TỪ NHẸ ĐẾN NẶNG

LỚP 1🔁 THỬ LẠI

Lớp 1: Retry On Fail cho lỗi tạm thời

Mở node cần bảo vệ, vào tab Settings, bật Retry On Fail rồi chỉnh hai thông số:

Nên bật cho các node gọi dịch vụ bên ngoài như HTTP Request, Google Sheets, Gmail, node AI. Với API hay báo lỗi 429, hãy đặt thời gian chờ lớn (3000 đến 5000 ms) để dịch vụ kịp “nghỉ”. Không nên bật cho node Code: lỗi trong code là lỗi logic, thử lại 5 lần vẫn sai y như nhau. Cẩn thận với node gửi email hay tin nhắn: nếu lỗi xảy ra sau khi tin đã đi, thử lại có thể gửi trùng.

LỚP 2⑂ RẼ NHÁNH

Lớp 2: On Error quyết định dừng hay đi tiếp

Cũng trong tab Settings, mục On Error có ba lựa chọn:

Ví dụ: workflow gửi email cho 50 khách, 2 địa chỉ bị sai. Với Continue (using error output), 48 email vẫn đi, còn 2 dòng lỗi được ghi vào sheet “LoiGuiEmail” để kiểm tra sau, thay vì cả đợt gửi dừng lại.

LỚP 3🚨 BÁO ĐỘNG

Lớp 3: Error Workflow báo động khi cả workflow thất bại

Error Workflow là một workflow riêng bắt đầu bằng node Error Trigger. Khi một workflow đang chạy tự động bị lỗi, n8n gọi Error Workflow đã gán và gửi kèm tên workflow, node lỗi, nội dung lỗi và link tới execution. Một Error Workflow có thể dùng chung cho nhiều workflow.

Với lỗi logic “im lặng”, hãy thêm node Stop and Error: ví dụ sau bước đọc dữ liệu, nếu số dòng bằng 0 thì cho đi vào Stop and Error với thông báo “Không có dữ liệu tuần trước”. Workflow sẽ dừng lại và Error Workflow gửi cảnh báo như một lỗi thật.

BƯỚC 1⚡ ERROR TRIGGER

Bước 1: Tạo workflow với Error Trigger

Tạo workflow mới, đặt tên “Báo lỗi workflow”, thêm node Error Trigger làm node đầu tiên rồi lưu lại. Workflow dùng Error Trigger không cần kích hoạt (Publish/Active) mới chạy được. Dữ liệu n8n gửi sang gồm: workflow.name, execution.url, execution.error.message, execution.lastNodeExecuted. Nếu lỗi nằm ngay ở node trigger của workflow chính, n8n không lưu execution nên không có execution.url, thông tin lỗi nằm trong trigger.error.

BƯỚC 2{ } CODE

Bước 2: Soạn tin nhắn cảnh báo bằng node Code

Thêm node Code (JavaScript), đặt tên “Soạn cảnh báo”, dán đoạn code sau. Code xử lý cả hai trường hợp: lỗi thường và lỗi ở node trigger.

1// Dữ liệu Error Trigger gửi sang
2const d = $input.first().json;
3const wf = d.workflow?.name ?? '(không rõ tên)';
4const ex = d.execution; // không có khi lỗi nằm ở node trigger
5const loi = ex?.error?.message ?? d.trigger?.error?.message ?? 'Không có mô tả lỗi';
6const node = ex?.lastNodeExecuted ?? d.trigger?.error?.node?.name ?? 'Node trigger';
7const thoiGian = $now.setZone('Asia/Ho_Chi_Minh').toFormat('dd/MM/yyyy HH:mm');
8
9const dong = [
10  `🚨 Workflow chạy hỏng: ${wf}`,
11  `🕒 ${thoiGian}`,
12  `📍 Node lỗi: ${node}`,
13  `❗ Lỗi: ${loi.slice(0, 300)}`
14];
15if (ex?.retryOf) dong.push(`🔁 Đây là lần chạy lại của execution ${ex.retryOf}`);
16dong.push(ex?.url ? `🔗 Xem chi tiết: ${ex.url}` : '🔗 Lỗi ở node trigger nên không có link execution');
17
18return [{ json: {
19  ThoiGian: thoiGian, Workflow: wf, NodeLoi: node, Loi: loi, Link: ex?.url ?? '',
20  tinNhan: dong.join('\n')
21} }];

Với một lỗi quá tải ở workflow báo cáo tuần, tin nhắn nhận được trông như sau (dữ liệu minh họa):

BƯỚC 3✈ TELEGRAM

Bước 3: Gửi cảnh báo qua Telegram

Thêm node Telegram, chọn thao tác Send Message, điền Chat ID của bạn hoặc của nhóm phụ trách, ô Text nhập {{ $json.tinNhan }}. Trong Additional Fields, tắt Append n8n Attribution để tin nhắn gọn hơn. Bật Retry On Fail cho node này với 3 lần thử, vì cảnh báo lỗi mà gửi không được thì cũng như không có.

BƯỚC 4▦ GOOGLE SHEETS

Bước 4: Ghi lịch sử lỗi vào Google Sheets

Nối thêm node Google Sheets (Append Row) song song với node Telegram, ghi vào sheet LichSuLoi các cột ThoiGian, Workflow, NodeLoi, Loi, Link. Sau vài tuần, bạn sẽ thấy workflow nào hay hỏng và hỏng vì lý do gì, từ đó sửa đúng chỗ.

BƯỚC 5⚙ SETTINGS

Bước 5: Gán Error Workflow và chạy thử

Mở từng workflow cần theo dõi, vào Options > Settings, ở mục Error workflow chọn “Báo lỗi workflow” rồi lưu.

Lưu ý quan trọng: Error Trigger chỉ chạy khi workflow chạy tự động bị lỗi, bấm chạy thử bằng tay sẽ không có cảnh báo. Để kiểm tra, tạo một workflow thử gồm Schedule Trigger chạy mỗi phút và node Stop and Error với nội dung “Thử cảnh báo lỗi”, gán Error Workflow, kích hoạt, đợi tin nhắn Telegram tới rồi tắt workflow thử đi.

☑ TRƯỚC KHI CHẠY THẬT

6/6 mục đạt → yên tâm để workflow tự chạy

📅 Muốn học bài bản cách xây workflow tự động hóa chạy ổn định? Xem lịch khai giảng tháng 10/2026 của MCNA để chọn lớp Data Analyst và AI Automation phù hợp.

Xử lý lỗi n8n không cần phức tạp: Retry On Fail cho lỗi tạm thời, On Error phù hợp cho từng node, Stop and Error cho kết quả bất thường và một Error Workflow 4 node gửi cảnh báo Telegram. Chỉ mất khoảng 30 phút cài đặt, bạn sẽ biết workflow hỏng trước khi sếp hỏi, kèm đúng node lỗi và link để sửa ngay.

Nếu bạn muốn học bài bản cách xử lý, phân tích dữ liệu và tự động hóa với AI, các khóa học tại MCNA Technology School sẽ đồng hành cùng bạn. Đọc thêm: Tự động hóa báo cáo tuần với n8n và AI, Chatbot Telegram hỏi đáp dữ liệu và n8n, Power Automate hay Make.

👉 Xem lịch khai giảng tháng 10/2026: Power BI, SQL, Python, AI – MCNA