10 lỗi n8n ‘kinh điển’ khiến workflow chết đứng & fix triệt để

Mở bài: Workflow của anh em đang “thở oxy” kiểu gì?

Anh em SME mình giờ ai cũng rần rần tự động hóa bằng n8n. Tôi cũng thế. Nhưng cái cảm giác sáng thứ Hai vào check, thấy workflow treo im re, dữ liệu không được đồng bộ, khách hàng khóc réo lên – thốn không chịu được. Đúng không?

Năm 2026 rồi, n8n đã update tới bản 4.x, AI agent tích hợp đầy mình, nhưng lỗi thì vẫn y nguyên như hồi 2023. Bản chất của tự động hóa là phải “chạy mãi mãi”. Nhưng thực tế, workflow của anh em cứ 3 bữa lại “đơ” như chưa từng được code.

Thực tế mà nói, tôi đã từng mất 3 ngày debug chỉ vì quên cái trigger đơn giản. SME mình không có đội DevOps hùng hậu, nên mỗi lần workflow chết là mất tiền, mất uy tín. Làm luôn nhé, hôm nay tôi sẽ mổ xẻ 10 lỗi “kinh điển” nhất, kèm cách fix không hàn lâm, chỉ có chiến.

Giải mã bình dân: Workflow n8n là “dây chuyền lắp ráp” hay “cỗ máy tự hủy”?

Hãy tưởng tượng workflow n8n như một dây chuyền đóng gói hàng trong kho. Mỗi node là một công nhân. Công nhân A nhận đơn, B lấy hàng, C dán nhãn, D gửi ship. Nếu thằng C bị đau bụng đi vệ sinh (lỗi), mà không có ai đứng chốt (error handler), cả dây chuyền tắc nghẽn. Hàng tồn, đơn hủy, sếp la.

Cái này mới quan trọng này: n8n không phải thần thánh. Nó là công cụ, nhưng cách anh em ráp nối mới quyết định sống chết. Nhiều người cứ nghĩ kéo thả vài cái là xong. Sai lầm chết người. Kết quả là, workflow chạy ngon lành lúc test, nhưng production thì “tèo” ngay khi gặp dữ liệu lạ.

Tôi thấy anh em SME thường mắc một lỗi tâm lý: “Có lỗi thì sửa, miễn là chạy được”. Nhưng trong automation, “chạy được” chưa đủ. Phải “chạy dai”, “chạy khỏe”. Nếu không, anh em sẽ thành “nô lệ” của chính workflow mình tạo ra.

Bước thực thi: 5 lỗi đầu tiên – “Kẻ hủy diệt” workflow âm thầm

Bắt đầu ngay nào. Tôi sẽ liệt kê 5 lỗi đầu tiên trong series 10 lỗi. Những lỗi này nghe đơn giản, nhưng tôi cá 8/10 anh em từng dính ít nhất một lần.

Lỗi #1: Sai kiểu dữ liệu ở node HTTP Request (và cách fix bất ngờ)

Đây là lỗi “kinh điển” nhất. Anh em gọi API từ một app nào đó, response trả về là một object, nhưng lại đem đi loop như một array. Kết quả là workflow báo lỗi “Cannot read property of undefined” ngay lập tức.

Fix triệt để: Trước khi đưa dữ liệu vào node tiếp theo, luôn dùng node “Code” hoặc “Function Item” để kiểm tra kiểu dữ liệu. Gõ lệnh console.log($input.first().json) xem nó là mảng hay object. Làm luôn nhé, thao tác này mất 30 giây nhưng cứu cả ngày debug.

Lỗi #2: Quên cài Timeout cho HTTP Request

Mặc định n8n để timeout 60 giây. Nhưng nếu API đối tác chậm, hoặc server của anh em yếu, workflow sẽ treo đến hết time rồi fail. Thực tế mà nói, tôi từng thấy một workflow gửi email marketing treo 45 phút vì chờ response từ một server mail cùi bắp.

Fix triệt để: Vào node HTTP Request, kéo xuống phần “Options”, set timeout xuống 15-20 giây. Đồng thời, bật “Retry on Fail” với 3 lần retry, mỗi lần cách nhau 5 giây. Như vậy, nếu lỗi tạm thời, workflow tự động chạy lại mà không cần anh em can thiệp.

Lỗi #3: Không xử lý lỗi (Error Handling) – Tội ác lớn nhất

Nhiều anh em xây workflow mà quên mất “Error Trigger” hoặc “Error Workflow”. Đây là cái sai cơ bản nhất. Khi một node chết, workflow dừng lại, không thông báo, không log. Sáng hôm sau mới tá hỏa. Anh em cần lưu ý, trong n8n, có hẳn một tab “Error Workflow” trong phần Settings. Hãy tận dụng nó.

Fix triệt để: Tạo một workflow riêng tên “Error Handler”. Workflow này chỉ làm một việc: gửi thông báo lỗi qua Telegram hoặc Slack, kèm link workflow gốc và nội dung lỗi. Sau đó, trong workflow chính, vào phần Settings, chọn “Error Workflow” và trỏ đến workflow vừa tạo. Cái này mới quan trọng này, nếu không làm, anh em đang chơi trò “bịt mắt bắt dê” với automation của mình đấy.

Lỗi #4: Webhook Response không đúng chuẩn

n8n thường dùng Webhook để nhận dữ liệu từ bên ngoài (Zalo, Facebook, CRM). Lỗi thường gặp là không trả về response đúng định dạng mà bên gọi yêu cầu. Ví dụ, Zalo yêu cầu trả về JSON có status 200, nhưng anh em lại để n8n trả về mặc định, dẫn đến bên kia gửi lại request liên tục, làm workflow chạy vòng lặp vô hạn.

Fix triệt để: Trong node Webhook, phần “Response Data” chọn “JSON”. Ở tab “Respond”, tạo một object đơn giản: {"status": "ok", "code": 200}. Nếu không chắc, hãy dùng node “Set” để tạo response trước khi kết thúc. Làm ngay, kẻo tối nay workflow lại “điên” lên vì bị spam request.

Lỗi #5: Credential hết hạn – Kẻ thù giấu mặt

Đây là lỗi âm thầm nhất. Token API của Google, Facebook, hoặc database cứ 30-60 ngày là hết hạn. Workflow vẫn chạy, nhưng khi credential die, nó die ngay lập tức. Thực tế mà nói, tôi có khách hàng bị mất dữ liệu báo cáo 2 tuần vì token Google Sheets hết hạn mà không biết.

Fix triệt để: Tạo một workflow “Health Check” riêng. Workflow này chạy mỗi ngày 1 lần, gọi thử một API đơn giản dùng credential đó. Nếu fail, gửi cảnh báo ngay. Cách khác: dùng node “Schedule Trigger” kết hợp “HTTP Request” để refresh token tự động nếu service hỗ trợ OAuth 2.0. Đừng để credential âm thầm giết chết workflow của anh em.

Hình ảnh minh họa: Khi tự host n8n, việc quản lý credential càng quan trọng hơn. Anh em nhớ backup thường xuyên nhé.

Tạm thời dừng ở 5 lỗi đầu. 5 lỗi còn lại (và cách fix “cực bự”) sẽ được bật mí trong phần tiếp theo. Nhưng tôi dám chắc, nếu anh em sửa ngay 5 cái này, workflow của anh em sẽ bớt “chết đứng” tới 60%.