🚨 n8n 에이전트 응급실: 증상별 처방전 |가나투데이
🚨 n8n 에이전트 응급실: 증상별 처방전
에이전트가 말을 안 듣나요? 99%는 신호 단절 또는 데이터 해석 오류입니다.
지금 겪고 있는 증상을 찾아 바로 해결하세요.
📋 빠른 증상 체크리스트
아래 증상 중 하나를 클릭해서 바로 해결책으로 이동하세요.
- 🔴 증상 1: 노드가 연결됐는데 다음 단계가 실행 안 됨
- 🟡 증상 2: 메시지에
{{ $json... }}같은 코드가 그대로 나옴 - 🟢 증상 3: 실행은 성공했는데 디스코드에 아무것도 안 옴
🔴 증상 1: 노드가 연결됐는데 다음 단계가 실행 안 됨
🩺 원인
데이터가 0개입니다. n8n은 흐를 데이터가 없으면 다음 노드를 실행하지 않습니다.
🔍 진단 방법
- 노드 사이 화살표 위의 숫자를 확인하세요
0 Items라고 나온다면 → 앞 노드에서 데이터가 전달되지 않은 것입니다
체크 포인트:
- 필터링 조건이 너무 엄격한가요?
- 트리거에서 데이터가 실제로 들어오고 있나요?
💊 해결책
방법 1: 트리거 노드 재점검
트리거 노드 선택 → [Test Step] 버튼 클릭 → 데이터가 실제로 유입되는지 확인
방법 2: 데이터가 없어도 계속 진행해야 한다면
해당 노드 설정 → Settings 탭 → "Continue on Fail" 옵션 활성화
🟡 증상 2: 메시지에 {{ $json... }} 같은 코드가 그대로 나옴
🩺 원인
n8n이 변수를 실제 값으로 변환하지 못하고 텍스트 그대로 출력한 상태입니다.
🔍 진단 방법
- 해당 노드의 왼쪽 Input 패널을 확인하세요
- 데이터가 실제로 들어와 있나요?
- 데이터 구조가 바뀌었나요?
- 예:
$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가지 습관
- 트리거 노드는 항상 Test Step으로 검증 - 데이터가 실제로 들어오는지 먼저 확인
- 변수는 직접 타이핑 금지 - 무조건 드래그 앤 드롭으로 입력
- Executions 탭을 수시로 확인 - 에러 로그는 가장 정직한 의사소견서
🔗 관련 글:
- n8n 기초: 첫 워크플로우 만들기
- 디스코드 봇 권한 설정 완벽 가이드
- 구글 폼 → 디스코드 자동화 템플릿
#가나 투데이 #ganatoday
그린아프로
