n8n 에러 핸들링 노드 : 안정적인 워크플로우 만들기

목차

    n8n 에러 핸들링 노드 : 안정적인 워크플로우 만들기

    새벽 3시, 워크플로우가 멈췄습니다. 아침에 출근해서야 에러를 발견합니다.

    에러 핸들링이 있었다면? 즉시 Slack 알림이 왔을 겁니다.

    이 글을 다 읽으면 에러 알림, 자동 재시도, 부분 실패 처리를 설정할 수 있습니다.

    ① n8n 에러 핸들링 필요성 — 새벽 3시 에러, 아침에 발견?

    🎭 왜왜씨와 딱딱씨의 대화
    🤔
    왜왜씨

    워크플로우가 에러 나면 그냥 다시 실행하면 안 되나요?

    🎯
    딱딱씨

    자동화는 사람이 안 보는 동안에도 돌아가잖아. 새벽 3시에 에러 나면 아침까지 모르는 거야!

    🤔
    왜왜씨

    아... 그래서 에러가 나면 알림을 받거나, 자동으로 재시도하게 해야 하는군요?

    🎯
    딱딱씨

    딱 맞아! 그게 바로 에러 핸들링이야. 안정적인 자동화의 필수 요소지.

    핵심

    에러 핸들링이 필요한 이유
    ✓ 에러 발생 시 즉시 알림 받기
    ✓ 일시적 오류는 자동 재시도
    ✓ 부분 실패해도 나머지는 계속 진행

    ② n8n Error Trigger — 에러 나면 즉시 알림

    Error Trigger는 워크플로우에서 에러가 발생했을 때 실행됩니다.

    Error Trigger 설정

    1. 새 워크플로우 생성
    2. Error Trigger 노드 추가
    3. 알림 노드 연결 (Slack, Email 등)
    4. 워크플로우 활성화

    💡 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 — 에러 나도 계속 진행

    특정 노드의 에러를 잡아서 다른 처리를 할 수 있습니다.

    노드 설정에서 에러 처리

    1. 노드 설정(Settings) 열기
    2. "Continue On Fail" 활성화
    3. 에러 발생해도 워크플로우 계속 진행

    에러 여부 확인

    // IF 노드에서 에러 체크
    {{ $json.error !== undefined }}
    
    // 에러 메시지 확인
    {{ $json.error?.message }}
    

    💡 Try/Catch 워크플로우 예시

    🔗 HTTP Request
    Continue On Fail
    🔀 IF
    에러 여부 확인
    True (에러)
    📊 에러 로그 저장
    False (정상)
    ▶️ 정상 처리 계속

    ④ n8n Retry 설정 — 실패하면 다시 시도

    일시적인 에러는 재시도로 해결될 수 있습니다.

    노드별 재시도 설정

    1. 노드 Settings 열기
    2. "Retry On Fail" 활성화
    3. 재시도 횟수, 대기 시간 설정

    재시도 설정 옵션

    옵션 설명 권장값
    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 즉시 알림

    3초 선택 가이드

    모든 에러 알림? → Error Trigger 워크플로우
    에러 나도 진행? → 노드 Settings → Continue On Fail
    자동 재시도? → 노드 Settings → Retry On Fail
    네트워크 오류? → 재시도 3회, 간격 5초

    다음 글 예고

    👉 n8n Webhook 노드 완벽 활용 : 외부 연동의 핵심


    에러 핸들링은 자동화의 안전벨트입니다.
    안정적인 워크플로우를 위해 꼭 설정하세요!

    댓글

    이 블로그의 인기 게시물

    n8n으로 업무 자동화 시작하기 : 왜 필요하고 어떻게 활용할까?

    n8n 데이터 처리 노드 : Set, Split, Merge 완벽 정리

    n8n 트리거 노드 : 3가지 유형으로 자동화 시작하기