n8n 에러 핸들링 노드 : 안정적인 워크플로우 만들기
목차
새벽 3시, 워크플로우가 멈췄습니다. 아침에 출근해서야 에러를 발견합니다.
에러 핸들링이 있었다면? 즉시 Slack 알림이 왔을 겁니다.
이 글을 다 읽으면 에러 알림, 자동 재시도, 부분 실패 처리를 설정할 수 있습니다.
① n8n 에러 핸들링 필요성 — 새벽 3시 에러, 아침에 발견?
워크플로우가 에러 나면 그냥 다시 실행하면 안 되나요?
자동화는 사람이 안 보는 동안에도 돌아가잖아. 새벽 3시에 에러 나면 아침까지 모르는 거야!
아... 그래서 에러가 나면 알림을 받거나, 자동으로 재시도하게 해야 하는군요?
딱 맞아! 그게 바로 에러 핸들링이야. 안정적인 자동화의 필수 요소지.
에러 핸들링이 필요한 이유
✓ 에러 발생 시 즉시 알림 받기
✓ 일시적 오류는 자동 재시도
✓ 부분 실패해도 나머지는 계속 진행
② n8n Error Trigger — 에러 나면 즉시 알림
Error Trigger는 워크플로우에서 에러가 발생했을 때 실행됩니다.
Error Trigger 설정
- 새 워크플로우 생성
- Error Trigger 노드 추가
- 알림 노드 연결 (Slack, Email 등)
- 워크플로우 활성화
💡 Error Trigger → Slack 알림
Slack 메시지 내용:
🚨 워크플로우 에러 발생!
워크플로우: {{ $json.workflow.name }}
에러 노드: {{ $json.execution.error.node.name }}
에러 메시지: {{ $json.execution.error.message }}
시간: {{ $now.setZone('Asia/Seoul').toFormat('yyyy-MM-dd HH:mm:ss') }}
Error Trigger가 받는 데이터
| 필드 | 내용 |
|---|---|
$json.workflow.name |
에러 발생 워크플로우 이름 |
$json.execution.id |
실행 ID |
$json.execution.error.message |
에러 메시지 |
$json.execution.error.node.name |
에러 발생 노드 |
③ n8n Continue On Fail — 에러 나도 계속 진행
특정 노드의 에러를 잡아서 다른 처리를 할 수 있습니다.
노드 설정에서 에러 처리
- 노드 설정(Settings) 열기
- "Continue On Fail" 활성화
- 에러 발생해도 워크플로우 계속 진행
에러 여부 확인
// IF 노드에서 에러 체크
{{ $json.error !== undefined }}
// 에러 메시지 확인
{{ $json.error?.message }}
💡 Try/Catch 워크플로우 예시
Continue On Fail
에러 여부 확인
④ n8n Retry 설정 — 실패하면 다시 시도
일시적인 에러는 재시도로 해결될 수 있습니다.
노드별 재시도 설정
- 노드 Settings 열기
- "Retry On Fail" 활성화
- 재시도 횟수, 대기 시간 설정
재시도 설정 옵션
| 옵션 | 설명 | 권장값 |
|---|---|---|
| Max Tries | 최대 재시도 횟수 | 3회 |
| Wait Between Tries | 재시도 간격 | 1000ms~5000ms |
API Rate Limit 에러는 재시도 간격을 길게 설정하세요! (5~10초)
⑤ n8n 에러 핸들링 모범 사례
권장 사항
- 중앙 에러 워크플로우 - Error Trigger로 모든 에러 수집
- 즉시 알림 - Slack, Email로 실시간 알림
- 상세 로깅 - 에러 내용, 입력 데이터 기록
- 점진적 재시도 - 간격을 늘려가며 재시도
에러 심각도별 처리
| 심각도 | 예시 | 대응 |
|---|---|---|
| 🟡 경미 | 일시적 네트워크 오류 | 자동 재시도 |
| 🟠 주의 | 데이터 형식 오류 | 로그 + 알림 |
| 🔴 심각 | 인증 실패, 권한 오류 | 즉시 알림 + 중단 |
n8n 에러 핸들링 공식 문서에서 더 많은 패턴을 확인하세요!
Error Trigger - 전역 에러 감지
Continue On Fail - 개별 노드 에러 처리
Retry On Fail - 자동 재시도
알림 - Slack/Email 즉시 알림
모든 에러 알림? → Error Trigger 워크플로우
에러 나도 진행? → 노드 Settings → Continue On Fail
자동 재시도? → 노드 Settings → Retry On Fail
네트워크 오류? → 재시도 3회, 간격 5초
👉 n8n Webhook 노드 완벽 활용 : 외부 연동의 핵심
에러 핸들링은 자동화의 안전벨트입니다.
안정적인 워크플로우를 위해 꼭 설정하세요!
댓글
댓글 쓰기