🚨 n8n 에이전트 응급실: 증상별 처방전 |가나투데이

🚨 n8n 에이전트 응급실: 증상별 처방전

에이전트가 말을 안 듣나요? 99%는 신호 단절 또는 데이터 해석 오류입니다.
지금 겪고 있는 증상을 찾아 바로 해결하세요.

---

📋 빠른 증상 체크리스트

아래 증상 중 하나를 클릭해서 바로 해결책으로 이동하세요.

• 🔴 증상 1: 노드가 연결됐는데 다음 단계가 실행 안 됨
• 🟡 증상 2: 메시지에 {{ $json... }} 같은 코드가 그대로 나옴
• 🟢 증상 3: 실행은 성공했는데 디스코드에 아무것도 안 옴

---

🔴 증상 1: 노드가 연결됐는데 다음 단계가 실행 안 됨

🩺 원인

데이터가 0개입니다. n8n은 흐를 데이터가 없으면 다음 노드를 실행하지 않습니다.

🔍 진단 방법

1. 노드 사이 화살표 위의 숫자를 확인하세요
2. 0 Items라고 나온다면 → 앞 노드에서 데이터가 전달되지 않은 것입니다

체크 포인트:

• 필터링 조건이 너무 엄격한가요?
• 트리거에서 데이터가 실제로 들어오고 있나요?

💊 해결책

방법 1: 트리거 노드 재점검

트리거 노드 선택 → [Test Step] 버튼 클릭 → 데이터가 실제로 유입되는지 확인

방법 2: 데이터가 없어도 계속 진행해야 한다면

해당 노드 설정 → Settings 탭 → "Continue on Fail" 옵션 활성화

---

🟡 증상 2: 메시지에 {{ $json... }} 같은 코드가 그대로 나옴

🩺 원인

n8n이 변수를 실제 값으로 변환하지 못하고 텍스트 그대로 출력한 상태입니다.

🔍 진단 방법

1. 해당 노드의 왼쪽 Input 패널을 확인하세요
2. 데이터가 실제로 들어와 있나요?
3. 데이터 구조가 바뀌었나요?
   • 예: $json.name인데 실제로는 $json.user_name인 경우

💊 해결책

올바른 데이터 매핑 방법:

1. 기존에 입력한 {{ $json.xxx }}를 모두 지우세요
2. 왼쪽 Input 패널에서 원하는 항목을 드래그 앤 드롭
3. 자동으로 정확한 경로가 입력됩니다

주의: 직접 타이핑하지 말고 드래그 앤 드롭으로 경로를 입력하세요. 이것이 가장 확실한 방법입니다.

---

🟢 증상 3: 실행은 성공했는데 디스코드에 아무것도 안 옴

🩺 원인

n8n은 신호를 보냈지만, 디스코드(목적지)에서 거절당한 경우입니다.

대표 원인:

• API 키 또는 웹훅 URL 오류
• 봇 권한 부족

🔍 진단 방법

화면 하단 Executions 탭 → 해당 노드 클릭 → Error 또는 Response 내용 확인

자주 나오는 에러:

• 403 Forbidden → 권한 문제
• 401 Unauthorized → 인증 문제
• 404 Not Found → URL 오류

💊 해결책

1단계: 자격 증명 재점검

노드 설정 → Credentials 항목 → API 키/웹훅 URL 확인

2단계: 디스코드 봇 권한 확인

디스코드 서버 설정 → 역할 관리 → 봇에게 "메시지 보내기" 권한 부여

3단계: 웹훅 URL 테스트

• 웹훅 URL을 복사해서 브라우저 주소창에 붙여넣기
• 정상 작동하면 디스코드 페이지가 보입니다

---

🆘 그래도 안 되면? 현장 브리핑 요청

위의 방법으로도 해결되지 않는다면, 아래 양식으로 정확한 상황을 알려주세요.

📝 트러블슈팅 요청 양식

1️⃣ 문제가 발생한 노드:
   예) Discord Send Message 노드

2️⃣ 확인된 에러 메시지:
   예) 403 Forbidden / No items found

3️⃣ 원하는 결과:
   예) 구글 폼 응답 내용을 디스코드로 받고 싶음

4️⃣ 현재 노드 연결 구조:
   예) Google Forms Trigger → Discord 노드

이 정보를 주시면 즉시 맞춤 처방을 내려드리겠습니다!

---

💡 예방 수칙: 에이전트를 건강하게 유지하는 3가지 습관

1. 트리거 노드는 항상 Test Step으로 검증 - 데이터가 실제로 들어오는지 먼저 확인
2. 변수는 직접 타이핑 금지 - 무조건 드래그 앤 드롭으로 입력
3. Executions 탭을 수시로 확인 - 에러 로그는 가장 정직한 의사소견서

---

🔗 관련 글:

• n8n 기초: 첫 워크플로우 만들기
• 디스코드 봇 권한 설정 완벽 가이드
• 구글 폼 → 디스코드 자동화 템플릿

#가나 투데이 #ganatoday

그린아프로