[[부록15_자주_하는_실수와_해결법_통합_가이드|부록 15]]. 자주 하는 실수와 해결법 통합 가이드
[!abstract] CH04~CH07 실습 과정에서 자주 발생하는 오류와 해결법을 주제별로 정리한 종합 트러블슈팅 가이드입니다. 각 실습 섹션에서 다루지 못한 추가 팁도 포함되어 있으니, 문제가 생겼을 때 해당 주제를 찾아 참고하세요.
이 부록은 다음 8개 주제로 구성됩니다.
| # | 주제 | 다루는 범위 |
|---|---|---|
| 1 | 인증 및 Credential | OAuth 만료, API 키 오류, Bearer Auth 등 |
| 2 | 표현식 및 데이터 매핑 | {{ }} 문법, 필드 오타, 타입 불일치 |
| 3 | Google 서비스 연동 | Sheets, Forms, Slides, Gmail, Drive |
| 4 | AI·LLM 노드 활용 | Chat Model, Information Extractor, Sentiment 등 |
| 5 | 메신저 및 외부 채널 | Telegram, Slack, SMTP, 카카오톡 |
| 6 | 데이터베이스 연동 | Data Table, Notion, Supabase |
| 7 | 루프·분기·배치 처리 | Loop, Switch, Split Out, Merge |
| 8 | MCP·RAG·고급 연동 | MCP, Vector Store, 커뮤니티 노드 |
1. 인증 및 Credential
n8n에서 외부 서비스와 연동할 때 가장 먼저 마주치는 문제는 인증입니다. API Key 오타, OAuth 만료, Credential 미등록 등은 초보자가 가장 자주 겪는 실수입니다.
| 증상 | 원인 | 해결법 |
|---|---|---|
| OAuth 인증 만료 (Google 서비스 401/403 오류) | GCP 앱이 테스트 모드인 경우, OAuth 토큰이 7일마다 만료 | n8n Credentials 페이지에서 해당 인증 정보를 클릭 → Sign in with Google 재인증. 영구 해결은 GCP에서 앱을 프로덕션 모드로 전환 (Google 검증 절차 필요) |
"Invalid API key" 오류 (LLM 노드) | API 키 오류 또는 해당 API 미활성화 | GCP Console에서 Gemini API 활성화 확인, Credential의 키 값 재확인. OpenRouter 등 다른 서비스도 동일하게 대시보드에서 키 상태 점검 |
"Quota exceeded" 오류 | API 무료 할당량 초과 | 잠시 기다렸다가 재시도, 또는 결제 수단 등록. Gemini 무료 티어는 분당/일당 요청 제한이 있음 |
"401 Unauthorized" (네이버 API) | Client ID 또는 Client Secret 누락/오타 | Headers에 X-Naver-Client-Id, X-Naver-Client-Secret이 정확히 입력되었는지 확인. 대소문자와 하이픈에 주의 |
"401 Unauthorized" (Firecrawl) | API 키 미등록 또는 만료 | Credential의 API 키 확인, Firecrawl Dashboard에서 재발급 |
"401 Unauthorized" (MCP Bearer Auth) | Bearer Auth 토큰 불일치 | MCP Server Trigger와 MCP Client Tool에 동일한 Bearer Auth Credential이 설정되어 있는지 확인 |
"Could not find integration" (Notion) | 데이터베이스에 Integration을 연결하지 않음 | Notion 데이터베이스 페이지에서 ... → Connections → 생성한 Integration 선택 → Confirm |
"Could not find database" (Notion) | Credential의 API Token이 잘못되었거나 다른 워크스페이스의 토큰 사용 | n8n Credential에서 Internal Integration Token을 재확인하고, 데이터베이스가 있는 워크스페이스의 토큰인지 점검 |
나이스 API "ERROR-300 필수 값 누락" | API Key가 Credential에 미등록이거나 필수 Query Parameter 누락 | Authentication이 "Query Auth"로 설정되었는지, Credential에 Name: KEY, Value: 발급 키가 정확한지 확인. Query Parameters도 빠진 항목 없는지 점검 |
카카오톡 전송 -401 오류 | OAuth2 토큰 만료 | n8n Credentials에서 카카오톡 OAuth2를 열고 Reconnect 클릭 |
Google Sheets 권한 오류 (403 Forbidden) | Credential의 OAuth 범위 부족 또는 만료 | Google Sheets Credential을 재인증하거나, OAuth 범위에 Sheets가 포함되어 있는지 확인 |
2. 표현식 및 데이터 매핑
표현식(Expression) 문법 오류와 데이터 매핑 실수는 n8n 워크플로에서 가장 빈번하게 발생합니다. 필드명 오타, 타입 불일치, {{ }} 누락 등을 점검하세요.
| 증상 | 원인 | 해결법 |
|---|---|---|
| 표현식 입력 후 빨간색 오류 표시 | {{ }} 중괄호를 빠뜨렸거나 필드명 오타 | Expression 모드인지 확인하고, {{ $json['이름'] }}처럼 중괄호 두 겹과 정확한 필드명 사용. 한글 필드명은 $json['필드명'] 형식(대괄호+따옴표) 필수 |
| Edit Fields에서 이전 노드 데이터가 사라짐 | Include Other Input Fields 옵션 미체크 | Edit Fields 노드에서 Include Other Input Fields를 반드시 On으로 설정. 이 실수는 가장 빈번하므로 항상 확인 |
Convert to File 노드 "data is not a string" 오류 | Text Input Field에 잘못된 필드명 입력 | 이전 노드(Markdown 등)에서 설정한 Destination Key와 동일한 값을 입력. OUTPUT에서 필드명 확인 |
| If 노드에서 항상 False로 분기 | Value 1의 표현식 경로가 잘못되어 undefined 반환 | HTTP Request 노드의 OUTPUT에서 실제 JSON 구조를 펼쳐보고, 경로가 정확히 일치하는지 대조 |
| 날짜 파라미터 오류 (API가 빈 결과 반환) | 날짜 형식이 YYYYMMDD가 아닌 YYYY-MM-DD로 전달 | .replaceAll('-', '') 또는 toFormat('yyyyMMdd') 적용 확인. Fixed 모드에서는 표현식 미동작 |
| Form 결과 페이지에 아무것도 표시되지 않음 | 데이터 추출 노드의 data 필드가 빈 배열이거나 Form 표현식 오타 | 데이터 추출 노드의 OUTPUT에서 data 필드 확인. Form의 Text가 Expression 모드이고 표현식이 올바른지 점검 |
| Create/Update 시 일부 속성이 비어 있음 | 속성 타입과 전송 데이터 타입 불일치 (예: Number 속성에 텍스트 전송) | 대상 서비스의 속성 타입(Text, Number, Select 등)과 n8n에서 매핑하는 데이터 타입이 일치하는지 확인 |
change_rate가 NaN 표시 | previous_price가 0이거나 빈값 | Google Sheets에서 해당 셀이 숫자인지 확인. 빈칸이나 문자가 섞이면 계산 불가 |
| Edit Fields에서 에러 발생 (빈 배열 접근) | items[0] 접근 시 배열이 비어있음 | 앞에 IF 노드를 추가하여 {{ $json.items.length }} > 0 인지 먼저 체크 |
Code 노드에서 undefined 반환 | return 문 누락 또는 잘못된 반환 형식 | 반드시 [{ json: {...} }] 형태의 배열을 반환 |
metadata.title이 undefined | 일부 페이지에서 메타데이터 누락 | Expression에 {{ $json.metadata?.title || '제목 없음' }}으로 기본값 설정 |
Markdown 노드 "Markdown is not set" 오류 | Markdown 필드를 비워둔 채 실행 | Markdown 필드에 표현식을 입력하고, Mode가 "Markdown to HTML"인지 확인 |
"Cannot read property of undefined" (Sheets 연동) | Sheets 컬럼명과 표현식의 키 이름 불일치 | Sheets 헤더가 수신처인데 $json['수신']로 쓴 경우 → 컬럼명을 정확히 일치시키세요 |
| 파일명에 공백이 포함되어 오류 | 동적 파일명에 공백 포함 | .replace(/ /g, '_') 표현식으로 공백을 언더스코어로 변환 |
3. Google 서비스 연동
Google Sheets, Forms, Slides, Gmail, Drive 등 Google 서비스 연동에서 발생하는 특수한 문제들입니다. OAuth 인증 문제는 "인증 및 Credential" 섹션을 참고하세요.
| 증상 | 원인 | 해결법 |
|---|---|---|
| Google Sheets에서 빈 행 이후 데이터를 못 읽음 | 시트 중간에 빈 행이 있으면 그 이후 데이터를 읽지 못함 | 시트에서 빈 행이 없도록 데이터 정리, 또는 Return All 옵션 활용 |
| Gmail 일일 발송 한도 초과 | 대량 이메일 발송 시 오류 | 대량 발송이 필요하면 배치 처리 구현, 또는 Google Workspace 계정 사용 |
| Google Sheets Trigger가 즉시 실행되지 않음 | 폴링(Polling) 방식이라 즉시 감지가 안 됨 | 정상 동작. 즉시 테스트하려면 Execute Workflow 버튼 사용 |
| Google Forms 응답이 감지되지 않음 | Forms의 응답(Responses) 탭에서 스프레드시트 연결 미확인 | Google Forms 응답 탭에서 Sheets 연결 확인, Trigger 노드의 Document와 Sheet 이름 재확인 |
| Google Slides 텍스트 치환이 안 됨 (플레이스홀더 그대로 남음) | 템플릿의 플레이스홀더 텍스트 불일치 | Slides 템플릿의 플레이스홀더가 정확히 [ NAME ]인지 확인 (공백, 대괄호 포함). Slides에서 텍스트를 직접 입력했는지 확인 |
| 이메일 도착하지만 PDF 첨부파일 없음 | Gmail 노드의 Attachments 설정 누락 | Attachments 옵션이 추가되었는지 확인. Binary Property 값이 data로 정확히 입력되었는지, Google Drive Download 노드의 출력에 바이너리 데이터가 있는지 확인 |
| Google Sheets에 데이터 추가 안 됨 | 시트 헤더와 JSON 키 불일치 | Sheets 1행의 헤더 텍스트와 Edit Fields의 키 이름이 완전히 동일한지 확인 (공백 포함) |
| Google Sheets Update 후 특정 열이 비어있음 | Edit Fields의 Include Other Input Fields가 Off | Edit Fields 노드에서 Include Other Input Fields를 On으로 설정 |
| Google Sheets에 같은 행이 중복 업데이트 | Matching Column이 잘못 설정됨 | Update Row의 Matching Column을 고유 식별자(예: 번호)로 설정하고, 해당 열이 시트에 존재하는지 확인 |
| Select 속성에 값이 저장되지 않음 (Notion) | Select 속성에 존재하지 않는 옵션 값 입력 | 데이터베이스에서 해당 Select 속성의 옵션 목록에 사용할 값이 미리 등록되어 있는지 확인 |
| Google Drive 파일 다운로드 실패 | 파일 공유 설정 미비 | 템플릿 파일의 공유 설정에서 "링크가 있는 모든 사용자" 읽기 권한 부여 |
4. AI·LLM 노드 활용
Basic LLM Chain, AI Agent, Information Extractor, Text Classifier, Sentiment Analysis 등 AI 관련 노드에서 발생하는 문제들입니다.
| 증상 | 원인 | 해결법 |
|---|---|---|
"Chat model is required" 오류 | Chat Model 서브노드 미연결 | AI 노드 하단의 Model 커넥터(●)를 클릭하여 Chat Model 연결. 1개의 Chat Model을 여러 노드에 공유 연결할 수 있음 |
| 요약/분류 결과가 영어로 나옴 | 프롬프트에 한국어 지시 없음 | 프롬프트를 한국어로 작성하면 대부분 한국어로 응답. 필요시 "한국어로 정리해주세요" 추가 |
| 요약 형식이 매번 다름 | Temperature가 너무 높음 | Temperature를 0.2~0.4로 조정. 요약·분류는 일관성이 중요하므로 낮은 값 권장 |
| 액션 아이템 누락 | 회의록에 담당자/기한이 불명확 | 프롬프트에 "명시적으로 언급되지 않은 담당자는 '미정'으로 표시" 등 지시 추가 |
| 요약이 너무 짧거나 길음 | 프롬프트에 분량 지시 부족 | "핵심 요약은 3~5개 항목"처럼 구체적인 분량을 프롬프트에 명시 |
| Information Extractor 결과가 빈값 | Attribute의 Description이 불명확 | Description을 상세히 작성 (예: "훅" → "시청자의 스크롤을 멈추게 하는 첫 문장") |
| Text Classifier 분류가 엉뚱함 | 카테고리 Description 미작성 | 각 카테고리에 해당하는 유형을 나열하여 Description 작성 |
| Text Classifier 출력이 항상 같은 카테고리 | 카테고리 간 경계가 모호 | 카테고리를 서로 겹치지 않게 재설계. 필요시 수를 줄여 테스트 |
| Sentiment Analysis가 "neutral"로만 나옴 | 텍스트에 감정 표현이 약함 | 감정 톤이 명확한 텍스트로 테스트하거나, 프롬프트에 톤 요청 추가 |
| AI 리포트 내용이 부실함 | 프롬프트가 짧거나 데이터 전달 오류 | Prompt Type이 Define으로 설정되었는지, Text 필드에 Expression이 올바르게 입력되었는지 확인 |
| AI가 도구를 호출하지 않음 | 질문이 도구와 관련 없는 일반적 내용 | 구체적인 사실 확인이 필요한 질문으로 테스트 (인물, 사건, 장소, 데이터 조회 등) |
| AI가 FAQ 내용과 무관한 답변 생성 | System Message에 규칙 부족 | "반드시 FAQ 검색 결과를 바탕으로 답변하세요" 규칙 추가 |
| 스크립트 생성 결과가 60초 초과 | 프롬프트 분량 지시 약함 | "반드시 60초 이내" 강조, 또는 "200자 이내"처럼 글자 수 제한 추가 |
5. 메신저 및 외부 채널
Telegram, Slack, 이메일(SMTP) 등 메시징 채널 연동에서 발생하는 문제들입니다.
| 증상 | 원인 | 해결법 |
|---|---|---|
Telegram 전송 실패 (401 Unauthorized) | Bot Token이 잘못됨 | Credential에 등록한 Bot Token 재확인 ([[부록07_텔레그램_봇_생성_및_n8n_연동_가이드 |
Telegram 전송 실패 (400 Bad Request: chat not found) | Chat ID가 잘못됨 | [[부록07_텔레그램_봇_생성_및_n8n_연동_가이드 |
| Telegram 봇이 응답하지 않음 | 워크플로 미발행 상태 | 캔버스 우측 상단 Publish 버튼을 클릭하여 발행 |
| Telegram 응답이 엉뚱한 곳으로 감 | Chat ID 표현식 오류 | $('Telegram Trigger').item.json.message.chat.id로 원본 트리거 참조 확인 |
| AI가 텔레그램 메시지를 이해 못 함 | Prompt 매핑 누락 | AI Agent의 Prompt를 Define below로 설정하고 Text에 $json.message.text 입력 |
| 텔레그램 대화가 다른 사용자와 섞임 | Memory Session ID 미설정 | Simple Memory의 Session ID를 $json.message.chat.id로 설정 |
Slack "dispatch_failed" 오류 | Webhook URL이 잘못되었거나 워크플로 미발행 | Production URL 확인 + Publish 상태 확인 |
| Slack 명령 입력 후 응답 없음 | Webhook Respond가 Immediately가 아니거나 응답 노드 미연결 | Webhook의 Respond를 Immediately로 설정, 응답 HTTP Request 노드 연결 확인 |
Slack "channel_not_found" | 채널명 오타 또는 Bot이 채널에 미초대 | 채널명 정확히 입력, Slack App을 해당 채널에 초대 (/invite @앱이름) |
"Cannot read properties of undefined" (Slack 봇) | 도시 이름 미입력 (/weather만 입력) | /weather 서울처럼 파라미터 포함하여 입력 |
response_url 요청 실패 (400/404) | response_url 만료 (슬래시 명령 후 30분 초과) | 정상 상황 — 30분 내에 워크플로 완료되면 해결 |
"Request URL must use HTTPS" (Slack) | n8n이 HTTP만 지원하는 환경 | n8n에 SSL/HTTPS 설정 필요 (리버스 프록시 또는 Cloudflare Tunnel 사용) |
"Connection refused" 이메일 오류 | SMTP Credential 미등록 또는 설정 오류 | [[부록08_네이버_메일_SMTP_연동_가이드 |
| 이메일은 발송되는데 본문이 비어 있음 | Email Format이 Text로 설정됨 | Send Email 노드의 Email Format을 HTML로 변경 |
카카오톡 전송 -2 오류 | template_object JSON 형식 오류 | Body Parameter 값이 올바른 JSON인지 확인 |
| 카카오톡에 메시지가 안 옴 | talk_message 동의 누락 | 카카오 개발자 콘솔에서 동의항목 확인 |
| SMTP 이메일에 첨부파일이 없음 | Send Email 노드의 Attachments 설정 누락 | Options → Attachments에서 data를 선택하여 직전 노드의 바이너리를 첨부 |
6. 데이터베이스 연동
n8n Data Table, Notion, Supabase 등 데이터 저장소 연동에서 발생하는 문제들입니다.
| 증상 | 원인 | 해결법 |
|---|---|---|
| Data Table Insert 시 데이터 미저장 | 컬럼명과 Edit Fields 필드명 불일치 | Mapping Mode를 Map Each Column Manually로 설정, 각 필드를 올바른 컬럼에 드래그 앤 드롭 매핑 |
| Data Table Get 조회 결과 0건 | Filter의 Key Value에 오타 또는 공백 차이 | 접수와 접 수(공백 포함) 등 정확한 값 입력 확인 |
| Data Table Update 후 데이터 미변경 | Filter 조건의 컬럼 타입 불일치 | Filter에서 컬럼명 옆의 타입(string, number)을 확인하고 올바른 타입 선택 |
| Data Table Delete가 동작하지 않음 | Dry Run이 Yes로 설정되어 미리보기만 수행 | 의도한 대상 확인 후, Dry Run을 No로 변경하여 다시 실행 |
| 전체 실행 버튼 클릭 시 일부 블록만 실행 | 독립된 여러 블록 중 최상단만 실행 | 각 블록의 트리거 노드를 직접 클릭하여 개별 실행 |
Notion Update 시 "page_id is required" | 조회 단계에서 Page ID를 확보하지 못함 | 필터 조건이 정확한지, 해당 ID가 데이터베이스에 존재하는지 확인 |
Supabase "function match_documents does not exist" | SQL 함수가 생성되지 않음 | [[부록11_Supabase_벡터_저장소_설정_가이드 |
임베딩 저장 시 "dimension mismatch" | 테이블 벡터 차원과 모델 차원 불일치 | documents 테이블의 embedding 컬럼이 vector(3072)인지 확인. gemini-embedding-001은 3,072차원 |
| 후속 질문에서 맥락이 끊김 (챗봇) | Simple Memory가 연결되지 않음 | AI Agent 노드의 Memory 포트에 Simple Memory가 연결되어 있는지 확인 |
| 검색 결과가 관련 없는 문서를 반환 | Vector Store의 Top K 값이 너무 큼 | Top K를 3 이하로 줄여 보세요. 값이 클수록 관련도가 낮은 문서도 포함 |
7. 루프·분기·배치 처리
Loop, Switch, Split Out, Merge 등 데이터 흐름 제어 노드에서 발생하는 문제들입니다.
| 증상 | 원인 | 해결법 |
|---|---|---|
| Loop가 첫 번째만 처리 | Loop 복귀 연결 누락 | 마지막 처리 노드의 출력을 Loop 노드의 입력(왼쪽)으로 연결 |
| Loop가 무한 반복 | 처리 결과를 Loop의 잘못된 포트에 연결 | Split In Batches의 입력(왼쪽)에 연결했는지 확인 |
| Loop 완료 후 다음 단계가 실행 안 됨 | done 포트 연결 누락 | Loop 노드의 done 포트(하단)에서 다음 노드로 연결. loop 포트(상단)와 혼동 주의 |
| Switch 노드에서 모든 데이터가 같은 경로로 이동 | 필드 값과 Switch 조건 문자열 불일치 | 이전 노드의 출력값과 Switch 조건 값이 정확히 일치하는지 확인 (공백, 대소문자 포함) |
| Split Out 후 아이템이 0건 | Field To Split Out 경로가 잘못됨 | 경로를 정확히 입력 (예: data.sentences, data). OUTPUT에서 실제 필드 구조 확인 |
| Split Out 후 아이템이 1건만 나옴 | 분리 대상이 아닌 상위 필드 입력 | 배열이 있는 정확한 경로를 입력했는지 확인 |
| Merge 결과에 필드가 빠져 있음 | 한쪽 브랜치가 아직 실행되지 않음 | 양쪽 브랜치를 모두 Execute step으로 실행한 뒤 Merge 실행 |
"429 Too Many Requests" | 외부 API 동시 호출 제한 초과 | 잠시 후 재시도, 또는 Loop의 Batch Size/Limit 수를 줄이기 |
8. MCP·RAG·고급 연동
MCP 서버/클라이언트, RAG(벡터 검색), 커뮤니티 노드 등 고급 기능에서 발생하는 문제들입니다.
| 증상 | 원인 | 해결법 |
|---|---|---|
MCP "Connection refused" / "ECONNREFUSED" | 서버 워크플로가 미발행 상태 | MCP Server 워크플로를 Publish하세요 |
MCP "Invalid URL" | SSE URL이 잘못됨 | URL 끝에 /mcp가 포함되어 있는지 확인 |
| MCP 도구 목록이 비어 있음 | Sub-Workflow Tool이 MCP Server Trigger에 미연결 | 캔버스에서 Tool 노드가 MCP Server Trigger에 연결되어 있는지 확인 |
MCP "Timeout" 오류 | 서버 응답이 느림 | MCP Client Tool의 Options → Timeout 값을 늘려보세요 (기본 60초) |
| MCP 서버 연결 시 알 수 없는 오류 | Sub-Workflow Tool 노드 이름에 한글 사용 | MCP 프로토콜은 도구 이름을 영문 기준으로 처리. Name 필드는 반드시 영문 (예: 공지사항조회 ❌ → get_notices ✅) |
서브워크플로 "Workflow not found" | 서브워크플로가 미발행 또는 Import 순서 오류 | 서브워크플로를 먼저 Import·Publish하고, 메인 워크플로의 Sub-Workflow Tool에서 올바른 워크플로 선택 |
| 연락처 검색 결과가 빈 배열 | Filter 조건 불일치 (대소문자, 공백) | 데이터 소스에서 실제 값 확인, 정확한 값으로 검색 |
| Vector Store Tool의 Description이 부정확해 AI가 도구 미호출 | Description에 구체적 키워드 부족 | Description에 "배송, 반품, 보증, 결제, 회원, 제품" 등 구체적 키워드 포함 |
채팅 위젯에서 "Connection refused" | n8n이 외부에서 접근 불가 | n8n의 Production URL이 공개 네트워크에서 접근 가능한지 확인 (Cloudflare Tunnel 등 활용) |
| Firecrawl Search 결과 0건 | 검색어가 너무 구체적이거나 영문/한글 혼용 | 영문 키워드를 사용하고 범위를 넓혀 재시도 |
| AI 분석이 빈 결과 (커뮤니티 노드) | Prompt Type이 "Auto"로 되어 있음 | Prompt Type을 Define으로 변경 |
| Pin 해제를 잊고 워크플로를 Publish | 테스트용 Pin 데이터가 고정된 상태에서 배포 | Publish 전 모든 노드의 핀 아이콘 확인, 테스트용 Pin은 반드시 Unpin으로 해제 |
"Form Trigger node must be set" 오류 | Form 노드가 있지만 Form Trigger가 없음 | 워크플로 시작에 Form Trigger 노드를 배치하고 연결 |
| Form Trigger에서 데이터 미수신 | Execute Workflow를 먼저 클릭하지 않고 폼 제출 | 반드시 Execute Workflow 클릭 후 폼 제출. 워크플로가 "대기" 상태여야 트리거 활성화 |
| Schedule Trigger가 실행 안 됨 | 워크플로가 미발행 상태 | 우측 상단 Publish 버튼을 클릭하여 발행 |
나이스 API "INFO-200 데이터 없음" | 학교코드 오류 또는 해당 기간에 급식 정보 없음 | 나이스 포털에서 코드 재확인. 조회 기간을 학기 중 평일로 변경 (방학·주말에는 데이터 없음) |
| 채팅창이 나타나지 않음 | Chat Trigger 미배치 | When Chat Message Received 노드가 캔버스에 있는지 확인 |
| HWPX 로고가 교체되지 않음 | 템플릿에 이미지가 없거나 Binary Property 이름 불일치 | HTTP Request의 Output Property Name과 HWPX 노드의 Image Binary Property가 동일한지 확인 (예: 둘 다 logo) |
추가 도움이 필요할 때
여기서 다루지 않은 오류는 다음 자료를 참고해 보세요.
- 공식 문서 검색: [[부록02_n8n_공식_문서_활용법|부록 02. n8n 공식 문서 활용법]] — 노드 문서의 "Common Issues" 섹션에 사례별 해결법이 정리되어 있습니다.
- 커뮤니티 질문: [[부록03_커뮤니티에서_도움_받기|부록 03. 커뮤니티에서 도움 받기]] — Forum, Discord, GitHub Issues 중 적합한 채널을 선택하고 좋은 질문을 작성하는 방법.
- 공유 시 보안: 워크플로 JSON에 API 키나 토큰이 포함되지 않도록 [[부록01_워크플로우_템플릿_라이브러리_활용법|부록 01]] 후반부의 익명화 체크리스트를 확인하세요.
💡 부록 시리즈 마무리: 부록 15까지 모두 따라오셨다면, 본문 실습에 필요한 모든 외부 서비스 연동 환경과 트러블슈팅 자료가 준비된 셈입니다. 실습 중 막힐 때는 이 통합 가이드의 8개 주제별 표를 펼쳐 빠르게 해결책을 찾으세요. 그래도 해결되지 않는다면 [[부록03_커뮤니티에서_도움_받기|부록 03. 커뮤니티에서 도움 받기]]를 참고하여 n8n 커뮤니티에 질문해 보세요.
