발행일: 2026-08-04(화) 03:14
도서하루 30분 n8n ①DAY 29
챕터 5 — 운영 & 성장난이도 ★★☆
DAY 29

트러블슈팅 : 막혔을 때 이렇게 해요

📖 이 DAY는 개념 학습 위주로 실습 파일이 없습니다
이론10
실습15
미션5

"나는 실패한 것이 아니다. 단지 작동하지 않는 방법 10,000가지를 찾아낸 것이다."

토머스 에디슨 (Thomas Edison, 발명가)
🎯 오늘의 학습 목표
  • 에러 번호(401/404/429 등)만 보고 원인과 해결 방향을 파악할 수 있다
  • 실행 로그에서 INPUT·OUTPUT을 비교하며 오류 발생 노드를 추적할 수 있다
  • Pin Data와 임시 Edit Fields로 구간 분리 테스트를 할 수 있다
에러 발생 시 이 순서대로 따라하세요
text
1단계: 캔버스에서 빨간 느낌표(!) 노드 찾기
2단계: 에러 메시지 확인 → 번호·핵심 단어 메모
3단계: 해당 노드 INPUT 탭 열어서 들어온 데이터 확인
4단계: 바로 앞 노드 OUTPUT 탭과 비교 → 원인 추적
5단계: 수정 후 재실행 → 초록 체크(✅) 확인
상황별 디버깅 방법
text
기법 1 — Pin Data (데이터 고정)
→ 문제 노드 앞 OUTPUT에서 📌 아이콘 클릭
→ 앞 노드 재실행 없이 뒤 노드만 반복 테스트 가능
→ API 비용 절약 효과

기법 2 — 임시 Edit Fields 삽입
→ 중간에 Edit Fields 노드를 끼워 데이터 구조 확인
→ 문제 해결 후 삭제

기법 3 — Executions 탭 추적
→ 실패 실행 클릭 → 노드별 INPUT·OUTPUT 순서대로 확인
→ "어느 노드까지는 정상, 어느 노드부터 이상" 범위 특정
💡 5xx 에러는 여러분 잘못이 아니에요! 외부 서비스(구글, Slack, OpenAI 등) 서버가 잠깐 불안정한 거예요. 잠시 기다렸다가 다시 실행해보세요. Retry On Fail을 설정해두면 자동으로 재시도해요.
🛠️ 실습
STEP 1일부러 에러 내기 — 404 에러 체험
  1. 새 워크플로우 'DAY29 에러추적 연습' 생성
  2. Manual Trigger → HTTP Request 노드 연결
  3. URL: https://httpstat.us/404 입력
  4. Execute Workflow 실행 → 빨간 느낌표 확인
  5. 에러 클릭 → Error Type·Message 메모
STEP 2실행 로그에서 원인 추적
  1. 좌측 Executions 탭 클릭
  2. 방금 실패한 실행(빨간 ❌) 클릭
  3. HTTP Request 노드 INPUT·OUTPUT 탭 확인
  4. 에러 번호와 해독표 대조 후 원인 파악
STEP 3Pin Data로 구간 분리 테스트
  1. Manual Trigger 노드 OUTPUT 패널에서 📌 아이콘 클릭
  2. URL을 https://httpstat.us/200 으로 교체
  3. Execute Workflow 재실행 → 초록 체크 확인
  4. Manual Trigger는 핀된 데이터 사용, HTTP Request만 재실행됨을 확인
STEP 4Retry On Fail 설정
  1. HTTP Request 노드 Settings → Retry On Fail: ON
  2. Max Tries: 3 / Wait Between Tries: 1000
  3. 저장 후 확인
Retry On Fail 설정값
text
Max Tries: 3
Wait Between Tries: 1000 ms
→ 실패 시 1초 간격으로 최대 3번 자동 재시도
🚀 오늘의 미션
  1. 에러 발생 시 자동 알림을 보내는 에러 알림 워크플로우를 만들어보세요
  2. 구성: Error Trigger → Edit Fields(에러 정보 정리) → Gmail 또는 Slack으로 알림 발송
  3. 다른 워크플로우 Settings → Error Workflow에 이 워크플로우를 연결한 뒤 의도적으로 에러를 내서 알림이 오는지 확인해보세요
n8n 계정이 없으신가요?n8n 무료 시작하기 ↗
← DAY 28
프로젝트 고도화 : 나만의 기능 추가
목차로DAY 30
30일 회고 & 나만의 자동화 로드맵 세우기