Dựa trên video hướng dẫn của n8n Official
Bạn có đang gặp khó khăn khi workflow của mình trong n8n đột nhiên không chạy đúng? Mình hiểu cảm giác bối rối khi nhìn thấy thông báo lỗi mà không biết phải giải quyết như thế nào.
Trong bài viết này, mình sẽ chia sẻ với bạn những kỹ thuật debug workflow trong n8n một cách hiệu quả, giúp bạn xác định và khắc phục lỗi nhanh chóng nhé!
Nội Dung Chính
Debugging là gì và tại sao nó quan trọng?
Debugging là quá trình tìm kiếm và sửa chữa lỗi trong workflow của bạn. Khi một workflow gặp vấn đề, thường là do một node cụ thể trong quy trình đó bị lỗi, dẫn đến việc toàn bộ workflow không thể hoàn thành.
Tại sao workflow thường bị lỗi:
- Node được cấu hình không chính xác
- Dịch vụ nền (như Google Sheets hoặc Slack) không khả dụng (lỗi 500)
- Dữ liệu đầu vào bị thiếu thông tin cần thiết
- Lỗi “ngầm” – workflow không báo lỗi nhưng cũng không thực hiện đúng chức năng
Ý Kiến Của Mình:
Việc nắm vững kỹ năng debug không chỉ giúp bạn sửa lỗi hiện tại mà còn giúp bạn xây dựng các workflow mạnh mẽ hơn trong tương lai. Mình thường thấy nhiều người bỏ cuộc với n8n vì không biết cách xử lý lỗi – đừng để điều đó xảy ra với bạn nhé!
Các tính năng Debug trong n8n
n8n cung cấp nhiều công cụ mạnh mẽ để giúp bạn debug workflow một cách hiệu quả. Hãy cùng khám phá từng công cụ và cách sử dụng chúng.
Các công cụ debug chính:
- Debug in Editor: Cho phép ghim dữ liệu từ lịch sử thực thi vào workflow hiện tại
- Retry Feature: Chạy lại các thực thi bị lỗi sau khi đã sửa lỗi
- Edit Output: Cho phép chỉnh sửa đầu ra của một node cụ thể
- Version History: Xem và khôi phục các phiên bản trước của workflow
Debug in Editor
Đây là công cụ mạnh mẽ nhất khi debug trong n8n. Tính năng này sao chép dữ liệu từ lần thực thi bị lỗi và ghim chúng vào workflow editor hiện tại của bạn. Dữ liệu được ghim sẽ có biểu tượng màu xanh hoặc tím ở góc dưới bên phải.
Lưu ý rằng một workflow chỉ có thể có một bộ dữ liệu được ghim tại một thời điểm, nên bạn cần xử lý các lỗi lần lượt nhé!
Retry Feature
Sau khi sửa lỗi, bạn có thể sử dụng tính năng Retry để kích hoạt lại tất cả các lần thực thi bị lỗi. Từ execution log, bạn có thể chọn retry với workflow đã lưu hiện tại hoặc với phiên bản workflow ban đầu từ thời điểm thực thi.
Cần lưu ý rằng retry chỉ thực thi từ node bị lỗi. Nếu lỗi đến từ node được cấu hình sai trước đó, bạn sẽ cần sử dụng Copy to Editor để thực thi lại từ đầu.
Edit Output
Tính năng này cho phép bạn chỉnh sửa thủ công đầu ra cho một node cụ thể. Rất hữu ích khi test hoặc debug, đặc biệt khi bạn đang làm việc với webhooks và không muốn phải gửi nhiều loại test events khác nhau.
Ý Kiến Của Mình:
Edit Output là một giải pháp tạm thời tuyệt vời, nhưng đừng lạm dụng nó! Tính năng này không mở rộng tốt cho các workflow phức tạp và có thể khiến bạn bỏ qua nguyên nhân gốc rễ của vấn đề. Hãy coi nó như một công cụ khẩn cấp hơn là giải pháp lâu dài nhé.
Version History
Khi debug và chỉnh sửa, đôi khi chúng ta có thể mất dấu điểm bắt đầu. Version History cho phép bạn xem tất cả các phiên bản trước đó của workflow đã được lưu.
Tính năng này cực kỳ hữu ích nếu bạn cần hoàn tác một số thay đổi đang gây ra lỗi hoặc để kiểm tra cấu trúc của một phiên bản workflow trước đó.
Thực hành Debug workflow với trường hợp thiếu ID
Hãy cùng đi vào một ví dụ thực tế để thấy quy trình debug trong hành động. Đầu tiên, chúng ta cần hiểu workflow đang làm gì khi nó hoạt động bình thường.
Quy trình workflow ban đầu:
- Nhận webhook với một ID
- Sử dụng ID để tìm thông tin người dùng trong Google Sheets
- Gửi thông tin người dùng (email, tên, công ty) qua tin nhắn Slack
Khi kiểm tra execution log, chúng ta thấy lỗi: “Error: cannot read properties of undefined reading toString”. Lỗi này xảy ra vì webhook không có trường ID.
Cách khắc phục:
Sử dụng tính năng Debug in Editor, chúng ta sẽ giải quyết vấn đề bằng cách thêm node IF để xử lý các trường hợp khác nhau:
// Trường hợp 1: Có ID hợp lệ
IF json.body.ID exists
→ Get user by ID
→ Send Slack message
// Trường hợp 2: Không có ID nhưng có email
ELSE IF json.body.email exists
→ Get user by email
→ Send Slack message
// Trường hợp 3: Không có cả ID và email
ELSE
→ Stop and throw error "No ID or email"
Ý Kiến Của Mình:
Cách tiếp cận này không chỉ sửa lỗi mà còn cải thiện tính linh hoạt của workflow! Thay vì chỉ xử lý một trường duy nhất, chúng ta đã mở rộng khả năng của workflow để xử lý nhiều trường hợp khác nhau. Đây chính là cách debug thông minh: không chỉ sửa lỗi mà còn nâng cấp hệ thống nhé!
Thực hành Debug workflow với trường hợp không tìm thấy người dùng
Tiếp theo, chúng ta xem xét một trường hợp khó phát hiện hơn: workflow không báo lỗi nhưng cũng không thực hiện chức năng đúng.
Trong ví dụ này, webhook nhận được ID hợp lệ, node Google Sheets thực thi nhưng không trả về dữ liệu, và không có tin nhắn Slack nào được gửi đi. Đây là ví dụ điển hình về lỗi “ngầm” mà mình đã đề cập.
Cách khắc phục:
- Sử dụng tính năng Copy to Editor (không phải Debug in Editor vì không có lỗi rõ ràng)
- Trong node Google Sheets, bật tùy chọn “Always Output Data” trong Settings
- Thêm node IF để kiểm tra xem có tìm thấy contact không (dựa vào trường email)
- Nếu tìm thấy contact (có email) → Gửi tin nhắn Slack
- Nếu không tìm thấy → Throw error “Contact not found in database”
// Trong node Google Sheets
// Bật "Always Output Data" trong Settings
// Sau node Google Sheets
IF json.email exists
→ Send Slack message
ELSE
→ Stop and throw error "Contact not found in database"
Ý Kiến Của Mình:
Một trong những kỹ năng debug quan trọng nhất là khả năng nhận biết khi nào một workflow đang “hoạt động đúng kỹ thuật” nhưng “sai về logic”. Bằng cách thêm những kiểm tra phù hợp, bạn không chỉ giúp workflow hoạt động mà còn cung cấp thông tin rõ ràng khi có vấn đề xảy ra. Debug không chỉ là việc sửa lỗi mà còn là xây dựng workflow thông minh hơn, tự báo cáo vấn đề một cách rõ ràng!
