19. n8n 자동화가 실패했을 때 확인해야 할 5가지
구글시트에 데이터가 하루 종일 안 들어와서 노드를 전부 지웠다가 다시 만들었어요. 나중에 보니 Credentials 인증이 만료된 게 원인이었어요. 30분이면 됐을 걸 2시간을 날렸어요.
n8n 오류는 대부분 전체를 다시 만들 필요가 없어요. 어느 노드까지 정상이었는지 추적하면 원인을 찾을 수 있어요. 이번 글에서는 자동화가 실패했을 때 확인해야 하는 5가지를 순서대로 정리할게요.
오류 해결의 핵심: "어느 노드까지 정상적으로 실행됐는가?"를 추적하는 것.
마지막 노드만 보지 말고, 앞에서부터 Output을 따라가야 해요.
자동화 실패 시 확인해야 할 5가지 — 이 순서대로
① Executions — 오류 나면 여기 먼저
Executions는 워크플로우 실행 기록이에요. 좌측 메뉴 또는 워크플로우 화면에서 접근할 수 있어요. 각 실행이 성공인지 실패인지 보여주고, 실패한 실행을 클릭하면 어느 노드에서 빨간 오류 표시가 났는지, 오류 메시지가 무엇인지 확인할 수 있어요.
- 실행 목록에서 실패한 기록 클릭하기
- 빨간 오류 표시가 난 노드 위치 확인하기
- 오류 난 노드 바로 앞 노드의 Output 확인하기
- 오류 메시지에서 핵심 단어 찾기 (unauthorized, not found, required, expired 등)
② 트리거 + Active 상태 — 실행 자체가 안 될 때
Executions 기록이 아예 없다면 워크플로우가 시작도 안 된 거예요. 트리거 또는 활성화 상태 문제예요.
- 워크플로우가 Active 상태인지 확인하기 (저장만으로는 자동 실행 안 됨)
- Schedule Trigger라면 Timezone이 Asia/Seoul인지 확인하기
- Webhook이라면 Production URL을 사용하는지 확인하기 (Test URL은 편집 중에만 작동)
- Gmail Trigger라면 Poll Time과 Credentials 확인하기
수동 실행과 자동 실행은 달라요. 수동 테스트가 성공해도 Active 토글을 켜지 않으면 트리거 기반 자동 실행은 작동하지 않아요.
③ Credentials + 권한 — 403·401 오류일 때
오류 메시지에 403, 401, unauthorized, forbidden, permission denied 같은 단어가 보이면 권한 문제예요.
- 노드에 올바른 Credentials가 선택되어 있는지 확인하기
- 연결된 계정이 해당 구글시트·파일에 편집 권한이 있는지 확인하기
- API 키나 Bot Token이 만료되지 않았는지 확인하기
- 필요하면 Credentials를 다시 연결하기
자동화 흐름이 완벽해도 권한이 없으면 실행되지 않아요. Credentials 오류는 초보자가 가장 많이 만나는 오류 중 하나예요.
④ Input / Output / 필드명 — 값이 비거나 이상할 때
구글시트에 빈 셀로 저장되거나, Telegram 메시지에 값이 안 보이거나, IF 노드가 항상 false로 빠질 때는 데이터 흐름 문제예요. 가장 흔한 원인은 필드명 불일치예요.
실제 Set 노드 Output 필드명: customer_email
→ 필드를 찾지 못해 값이 비어서 표시돼요.
- 오류 난 노드 바로 앞 노드의 Output 탭을 열어서 실제 필드명 확인하기
- 표현식 {{$json.필드명}}에서 필드명이 Output과 정확히 일치하는지 확인하기
- 값이 비어 있거나 null로 들어오는지 확인하기
- IF 노드라면 조건에 사용한 필드명이 이전 노드 Output과 같은 이름인지 확인하기
⑤ 외부 서비스 오류 코드 — 숫자가 보이면 여기서 확인
오류 메시지에 숫자 코드가 보이면 그 코드가 원인을 알려줘요. 코드별 의미를 알면 어디를 고쳐야 할지 빠르게 파악할 수 있어요.
오류 코드가 보이면 노드 설정을 바꾸기 전에 코드 의미를 먼저 확인하는 게 시간을 아끼는 방법이에요.
오류 해결할 때 초보자가 자주 하는 실수
노드를 다 지우고 처음부터 다시 만든다
대부분의 오류는 전체를 다시 만들 필요가 없어요. Executions에서 원인을 먼저 파악하고, 그 노드만 수정하는 게 훨씬 빨라요.
오류 메시지를 읽지 않는다
영어 문장이 어렵더라도 403, not found, required, expired 같은 단어만 찾아도 방향이 잡혀요. 오류 메시지는 원인을 알려주는 신호예요.
마지막 노드만 확인한다
Google Sheets 노드에서 오류가 났어도 원인이 Set 노드에 있을 수 있어요. 항상 오류 난 노드 바로 앞 노드 Output부터 확인하는 습관이 필요해요.
필드명을 추측해서 표현식을 작성한다
{{$json.email}}이라고 입력했는데 실제 필드명이 customer_email이면 값이 비어요. Output 탭에서 실제 이름을 확인한 뒤 입력하는 게 기본이에요.
권한 문제를 데이터 문제로 착각한다
문서가 보이지 않거나 저장이 안 될 때는 데이터가 아니라 권한 문제일 수 있어요. 연결한 계정이 해당 서비스에 접근할 수 있는지 먼저 확인해야 해요.
Error Workflow — 실패를 자동으로 알림받는 방법
워크플로우가 많아지면 매번 Executions를 확인하기 어려워요. 이때 Error Trigger를 활용하면 다른 워크플로우가 실패했을 때 알림을 받는 오류 처리 워크플로우를 만들 수 있어요.
Error Trigger → Set 노드(오류 정보 정리) → Telegram 또는 이메일 알림
기본 오류 확인 방법을 충분히 익힌 뒤 운영 단계에서 추가하는 게 좋아요. Error Trigger는 수동 실행 테스트에서는 작동하지 않고, 실제 자동 실행 중 오류가 발생해야 동작해요.
오류 해결 중 주의해야 할 보안 포인트
- 오류 화면 공유 전 개인정보·토큰 가리기
- 실제 고객 데이터 대신 샘플 데이터로 오류 재현하기
- 워크플로우 공유 시 Credentials 포함 여부 확인하기
- 실패 알림 메시지에 민감한 고객 정보를 과도하게 넣지 않기
마무리: 순서대로 따라가면 대부분 찾을 수 있다
오류가 나면 이 순서대로 확인하면 돼요.
- Executions — 실행됐는가? 어느 노드에서 멈췄는가?
- 트리거 + Active — 실행 자체가 안 됐다면 여기 확인
- Credentials + 권한 — 403·401 오류라면 여기 확인
- 이전 노드 Output — 값이 비거나 이상하면 필드명부터 확인
- 오류 코드 — 400·401·403·404·429 코드 의미 파악
대부분의 오류는 이 5가지 안에서 원인을 찾을 수 있어요. 전체를 다시 만들기 전에 Executions부터 열어보는 습관이 가장 중요해요.
다음 글에서는 n8n 초보자가 자주 하는 실수 10가지와 해결 방법을 정리할게요. 지금까지 배운 트리거, 노드, 데이터 흐름, 인증, 자동 실행 개념을 바탕으로 실무에서 자주 막히는 부분을 한 번에 점검해볼게요.
※ 이 글은 n8n 비개발자 자동화 시리즈 19화입니다. n8n의 기능과 화면은 버전에 따라 달라질 수 있으며, 실제 사용 전에 공식 문서를 함께 확인해주세요.
참고자료
- n8n Docs, Executions
- n8n Docs, Debug and re-run past executions
- n8n Docs, Manual, partial, and production executions
- n8n Docs, Saving and publishing workflows
- n8n Docs, Schedule Trigger common issues
- n8n Docs, Webhook node workflow development
- n8n Docs, Credentials library
- n8n Docs, Google OAuth2 credentials
- n8n Docs, How n8n structures data
- n8n Docs, Expression reference
- n8n Docs, Referencing previous nodes
- n8n Docs, Error handling
- n8n Docs, Error Trigger node
- n8n Docs, Execution data redaction
- n8n Docs, Securing n8n
- MDN Web Docs, HTTP response status codes