n8n의 IF 노드는 단순 조건문을 넘어 자동화 흐름의 ‘신경 중추’ 역할을 합니다. 실제 현장에서는 “왜 내 조건이 제대로 작동하지 않을까?”라는 고민이 자주 나옵니다. 값이 확실히 맞는데도 동작하지 않거나, 예상과 다르게 흐름이 분기되기도 합니다. 이 문제는 단순한 문법 오류라기보다는, 데이터 유형이나 비교 논리에서 발생하는 작은 차이에서 시작됩니다. 다양한 워크플로우를 검토해보면, 대부분 IF 노드 설정 시 생각보다 평범한 실수에서 문제가 비롯된다는 사실을 알 수 있습니다.
실무에서는 IF 노드가 틀리는 이유를 조건식 자체보다 입력 데이터의 모양에서 먼저 찾는 편이 훨씬 빠르다. 특히 문자열과 숫자, null과 빈 문자열, 공백이 섞여 들어오는 지점을 먼저 확인해두면 분기 오류를 줄이기 쉽다.
n8n IF 노드의 본질 흐름 제어의 중심축
n8n IF 노드는 true/false의 두 출력 포트만 제공하는 것처럼 보이지만, 실제로는 훨씬 넓은 범위의 흐름 제어가 가능합니다. “A가 B와 같다”와 같은 단순 비교를 넘어 JSON 객체, 배열, 날짜, null 값 등 다양한 데이터를 분기 조건으로 활용할 수 있습니다. 다만, 이런 유연함이 오히려 초보자에게 혼란을 줄 수 있습니다. 데이터가 눈으로 보이는데도 조건이 맞지 않아 흐름이 예상과 달라지는 경우가 대표적입니다.
핵심은 데이터가 어떻게 전달되는지를 정확히 파악하는 것입니다. n8n은 모든 데이터를 JSON 기반으로 처리하며, IF 노드는 이 형태를 그대로 해석합니다. 따라서 단순히 보이는 값만이 아니라 실제 흐름상 전달되는 데이터의 타입과 경로를 꼼꼼히 확인해야 올바른 조건식을 만들 수 있습니다.
1. 기본 조건 설정 비교 연산자와 데이터 경로
n8n IF 노드는 ‘왼쪽 값(Left)’, ‘비교 연산자(Operation)’, ‘오른쪽 값(Right)’의 세 가지 항목으로 구성됩니다. 이 중 가장 흔한 실수는 ‘왼쪽 값’에 {{ $json.field }}와 같은 표현식 대신, 그냥 “status”처럼 문자열로 입력하는 경우입니다. 이럴 경우, 실제 값이 아닌 문자열 “status”와 비교하게 되어 항상 false가 나옵니다.
예를 들어, 이전 노드의 데이터가 { “status”: “success” }라면, 왼쪽 값에는 반드시 {{ $json.status }}를 입력해야 합니다. 오른쪽 값에는 “success”와 같이 고정 문자열 또는 숫자가 들어갑니다. 이때 “1”과 1처럼, 문자열과 숫자는 엄격하게 구분됨을 반드시 유념해야 합니다.
2. 빈번한 오류 데이터 타입 불일치 및 공백 문제
외부 API 데이터는 예상과 다른 포맷으로 들어오는 경우가 흔합니다. 예를 들어, ID가 숫자여야 하지만 문자열로 넘어오거나, 상태 값 끝에 보이지 않는 공백(예: \u00a0)이 들어가는 일이 있습니다. 이런 경우 IF 노드는 조건을 만족시키지 못해 잘못된 경로로 흐르면, 원인을 찾지 못해 막히기 쉽습니다.
이런 상황에서는 IF 노드 앞 단계에서 Function 노드나 Set 노드로 데이터를 미리 정제하는 것이 중요합니다. 또는, IF 노드 조건식에 trim()이나 toString() 등 내장함수를 활용할 수도 있습니다. 예를 들어, {{ $json.status.trim() }} === “active”와 같이 설정할 수 있지만, 복잡한 정제는 가독성을 위해 별도 노드에서 처리하는 것이 좋습니다.
고급 분기 전략 다중 조건과 중첩 적용
복잡한 비즈니스 로직을 처리하려면 단일 조건만으로는 부족합니다. n8n의 IF 노드는 AND/OR을 직접 지원하지 않지만, 여러 노드를 조합하여 대응할 수 있습니다.
3. AND 조건 구현 IF 노드 연쇄 연결
“status가 active이고, score가 80 이상일 때”와 같은 조건은 두 개의 IF 노드를 순차적으로 연결하여 구현할 수 있다. 먼저 첫 번째 IF 노드에서 status를 확인한 뒤, 참인 경우에만 그 다음 IF 노드에서 score 조건을 검사한다. 두 조건을 모두 충족할 때만 최종 액션 노드로 흐름이 이어진다.
이 방법의 장점은 각 조건을 개별적으로 확인하고 디버깅할 수 있다는 점이다. 특정 조건에서 흐름이 중단된 경우, 어디에서 멈췄는지 쉽게 파악할 수 있어 문제 원인 추적이 용이하다.
4. OR 조건 구현: 병렬 분기 후 병합
예를 들어 “status가 pending이거나 retry_count가 3 이상일 때”와 같은 OR 조건은 단순한 구조보다 조금 더 신경을 써야 합니다. 일반적으로는 IF 노드를 두 개 나란히 배치한 뒤, 각각의 true 경로를 같은 후속 노드로 연결하면 됩니다. 다만, 이 경우에는 후속 노드가 중복으로 실행될 수 있으니 주의해야 합니다.
더 깔끔하게 정리하고 싶다면 Function 노드를 사용해 조건을 직접 평가한 후, 그 결과를 단일 IF 노드에 넘기는 방식이 있습니다. 예를 들어 아래처럼 작성할 수 있습니다. return { pass: (status === ‘pending’ || retry >= 3) }; 이후 IF 노드에서는 {{ $json.pass }} === true 조건으로 분기하면 중복 처리 우려가 줄어듭니다.
| 조건 유형 | 권장 구현 방식 | 주의사항 |
|---|---|---|
| 단일 조건 | 단일 IF노드 사용 | 데이터 유형과 경로 정확히 확인 |
| AND 조건 | IF노드 직렬 연결 | 흐름이 길어지면 가독성 저하 |
| OR 조건 | 병렬 IF + 병합 또는 Function 노드 활용 | 중복 실행 방지 필수 |
5. 날짜 및 시간 기반 분기
“오늘 날짜가 특정 기준일 이후인지” 판단하려면, n8n IF 노드에서 Date 객체를 사용할 수 있습니다. 예를 들어 {{ new Date($json.created_at) > new Date(‘2023-01-01’) }} 처럼 조건을 구성할 수 있습니다. 다만, 시간대 문제 때문에 예기치 않은 결과가 나올 수 있으니, 가능하다면 UTC 기준으로 변환하거나 Function 노드에서 미리 맞춰주는 것이 안전합니다.
현재 시각과의 비교가 필요할 때는 {{ Date.now() }}를 쓰면 됩니다. 이 값은 워크플로우가 실행된 순간의 타임스탬프이므로 실행 시점마다 결과가 달라질 수 있다는 점도 고려해야 합니다.
6. null 및 undefined 처리
필드가 없거나 비어 있을 때 IF 노드는 어떻게 동작할까요? 기본적으로 {{ $json.missing_field }}와 같이 존재하지 않는 필드를 참조하면 undefined가 되며, 대부분의 비교 연산에서는 false로 처리됩니다. 명확하게 null 여부를 확인해야 된다면, {{ $json.field === null }} 또는 {{ typeof $json.field === ‘undefined’ }} 처럼 조건식을 넣을 수 있습니다.
실무에서는 필드가 존재하는지부터 먼저 검사하고, 값이 있을 때만 추가 조건을 적용하는 것이 더 안전합니다. 복잡한 검증 로직이 필요하면 IF 노드 대신 Function 노드에서 try-catch를 쓰는 것도 좋은 방법입니다.
📌 핵심 포인트 & 주의사항
n8n IF 노드는 ‘표현식의 반환값’을 기준으로 분기합니다. 눈으로 보기에 값이 같아 보여도, 실제 내부 데이터(예: JSON)의 경로나 타입이 정확히 맞아야 조건이 올바르게 동작합니다. 특히 문자열 비교에서는 대소문자와 공백 차이로 인해 오류가 쉽게 발생하니, 항상 데이터를 직접 확인하고 엄격하게 처리해야 합니다.
FAQ: 자주 묻는 질문
Q. n8n IF 노드에서 숫자와 문자열을 구분하지 않고 비교할 수 있나요?
A. IF 노드는 엄격한 비교(===)를 적용하므로 “5”와 5는 서로 다릅니다. 같은 값으로 취급하려면 두 값을 모두 문자열이나 숫자로 형변환해야 합니다. 예를 들어 {{ $json.value.toString() }} === “5” 또는 {{ parseInt($json.value) }} === 5 처럼 처리할 수 있지만, 타입 변환 과정에서 오류가 생길 수 있으니 입력값의 유효성 검사를 먼저 해야 합니다.
Q. IF 노드에서 false 분기를 쓰지 않고 비워둬도 괜찮나요?
A. 네, false 경로에 노드를 연결하지 않으면 해당 경우는 그대로 흐름이 종료됩니다. 조건이 맞는 경우에만 알림을 보내고, 아니면 아무것도 하지 않는 구조에 유용합니다. 단, 디버깅을 할 때는 Debug 노드를 임시로 연결해놓는 것이 도움이 됩니다.
Q. IF 노드만으로 3개 이상의 분기 처리가 가능한가요?
A. IF 노드만으로는 3개 이상의 분기 처리가 직접적으로 어렵습니다. 하지만 IF 노드를 여러 개 연속해서 사용하거나, Switch 노드(커뮤니티 노드)를 활용하면 여러 갈래로 분기할 수 있습니다. 또는 Function 노드에서 case 문을 작성해 분기 값을 생성한 다음, 이 값을 기준으로 여러 IF 노드를 조합하는 방법도 활용할 수 있습니다.
n8n의 IF 노드는 구조상 단순해 보이지만, 워크플로우의 정확성과 유연성을 결정짓는 핵심 기능입니다. 조건에 따라 잘못된 메일이 발송되거나 결제 누락 등 사고가 발생할 수 있으니, IF 노드의 조건식을 꼼꼼히 확인하는 것이 무엇보다 중요합니다. 워크플로우를 실행하기 전에 IF 노드 조건을 다시 한번 점검해보시기 바랍니다.
참고 자료: n8n 공식 문서 – IF 노드
