ARTICLE_ID: EHUB-AUTO-GUIDE-001 | Version: V1.0 | Status: PUBLISHED SAMPLE
Khi workflow n8n lỗi, cách nhanh nhất không phải sửa nhiều node cùng lúc mà là thu hẹp phạm vi lỗi rồi kiểm chứng từng giả thuyết.
1. Chụp đúng hiện tượng
Ghi execution ID, node dừng, thông báo lỗi và dữ liệu đầu vào. Không dùng câu mô tả mơ hồ như “workflow không chạy”.
2. Tách lỗi thành 3 nhóm
- Credential: quyền, token, scope, kết nối.
- Dữ liệu: trường thiếu, kiểu dữ liệu sai, mapping lệch.
- Logic: điều kiện, nhánh, merge, loop, retry.
3. Giảm phạm vi kiểm thử
Chạy từ node gần lỗi nhất với dữ liệu mẫu nhỏ. Ưu tiên QA trước Production.
4. Kiểm tra expression
So sánh tên trường thật ở input với expression đang dùng; tránh suy đoán theo schema cũ.
5. Kiểm tra write target
Với Google Sheets hoặc CRM, xác minh đúng file, tab, cột, row key và chế độ append/upsert.
6. Sửa tối thiểu
Chỉ thay node hoặc mapping liên quan, giữ nguyên phần đang PASS.
7. Chạy ca nghiệm thu
Định nghĩa PASS/FAIL trước khi chạy lại: số dòng tạo mới, trạng thái cập nhật, log và dữ liệu đầu ra.
Checklist nhanh
- ☐ Có execution ID và node lỗi
- ☐ Đã phân loại credential/data/logic
- ☐ Đã test QA
- ☐ Đã xác định PASS/FAIL
- ☐ Không sửa Production khi chưa cần
Nguồn tham khảo
Cập nhật: 19/11/2026. Nội dung được biên tập theo EHUB EDITORIAL & DESIGN V1.1.




