n8n Merge 노드 완벽 가이드 데이터 합치기 전략

n8n의 Merge 노드는 겉보기엔 단순하다. 두 갈래로 나뉜 데이터를 다시 하나로 합치는 역할이라고 생각하면 얼추 맞다. 그런데 실제로 워크플로우를 운영하다 보면, 바로 이 노드에서 가장 많이 막힌다. 한쪽에는 고객 정보가 있고 다른 한쪽에는 주문 내역이 있는데, 막상 합치고 나면 고객 정보만 남거나, 주문 내역만 덮어써지거나, 서로 전혀 다른 사람의 데이터가 묶여서 나오기도 한다. 이쯤 되면 “왜 내 데이터가 하나로 합쳐지지 않지?”라는 생각이 들 수밖에 없다.

저도 처음에는 Merge 노드를 너무 단순하게 봤다. 그냥 두 갈래를 다시 붙여주는 노드라고 생각했다. 그런데 몇 번 직접 붙여보니, 이 노드는 “두 데이터를 이어붙이는” 노드라기보다 “어떤 기준으로 두 입력을 조합할지 결정하는” 노드에 더 가깝다는 걸 느끼게 됐다. 기준을 제대로 이해하지 못하면, 데이터가 안 합쳐지는 게 아니라 엉뚱하게 합쳐지는 쪽이 더 무섭다.

많은 글이 여전히 Merge 노드를 위치 기준과 키 기준 정도로만 설명하지만, 현재 공식 문서 기준으로는 Merge 노드가 훨씬 더 다양한 결합 방식을 지원한다. Append, Combine, SQL Query, Choose Branch 같은 큰 틀이 있고, Combine 안에서도 Position, Matching Fields, All Possible Combinations 같은 방식이 있다. 즉 지금의 Merge 노드는 예전처럼 “둘 중 하나를 고른다” 수준이 아니라, 두 입력 데이터를 어떤 규칙으로 재구성할지 선택하는 데이터 결합 노드에 가깝다.

이 지점에서 중요한 건 기능을 많이 아는 것보다, 어디서부터 틀어지기 쉬운지 먼저 감을 잡는 일이다. Merge 노드는 데이터를 단순히 붙이는 노드가 아니라, 어떤 기준으로 같은 항목으로 볼지를 정하는 단계에 가깝다.

그래서 이 글에서는 원문의 실무 감각은 살리되, 현재 n8n 문서 기준과 실제 운영 기준에 맞게 Merge 노드를 다시 정리해보려 한다. 어떤 상황에서 Position을 쓰고, 언제 Matching Fields를 써야 하며, Append와 Combine은 무엇이 다른지, 같은 이름의 필드가 충돌하면 어떻게 정리해야 하는지, 그리고 실제로 어떤 테스트를 해보면 병합 기준이 맞는지 빨리 확인할 수 있는지를 실무 기준으로 풀어보겠다.

직접 여러 번 써보니, Merge 노드는 데이터를 합치는 노드라기보다 “두 갈래에서 온 데이터를 어떤 규칙으로 믿고 묶을지 정하는 노드”라고 보는 쪽이 훨씬 덜 헷갈렸다.

n8n Merge 노드의 작동 원리 입력 흐름을 한눈에 이해하기

n8n에서는 각 노드가 아이템 단위로 데이터를 주고받는다. 두 갈래의 API 호출이나 데이터 변환 흐름이 있다면, Merge 노드는 그 두 입력을 받아 하나의 결과 스트림으로 재구성한다. 중요한 건 이 노드가 단순히 “둘 다 오면 붙인다” 수준이 아니라, 어떤 방식으로 묶을지 먼저 정해야 한다는 점이다. 이 설정이 Merge 노드의 핵심이다.

현재 공식 문서 기준으로 Merge 노드는 크게 Append, Combine, SQL Query, Choose Branch 방식으로 동작할 수 있다. Append는 말 그대로 한 입력 뒤에 다른 입력을 이어붙이는 형태이고, Combine은 두 입력을 어떤 기준으로 조합하는 방식이다. SQL Query는 조금 더 고급 사용 사례에 가깝고, Choose Branch는 특정 입력 흐름을 선택하는 데 쓰인다. 즉 Merge는 단순 병합 노드가 아니라, 두 입력을 어떤 논리로 결합할지 고르는 허브 노드에 가깝다.

이걸 이해하지 못하면 “왜 합쳐지지 않지?”라고 느끼기 쉽다. 실제로는 합쳐지지 않은 게 아니라, Append처럼 단순 연결된 결과를 기대하지 않고 Combine 기준으로 봐야 하는 상황일 수 있다. 반대로 Matching Fields를 써야 하는데 Position으로 묶으면, 데이터는 합쳐지긴 하지만 완전히 엉뚱하게 붙을 수 있다. 이게 Merge 노드가 어려운 이유다. 실패가 아니라 “틀린 성공”이 자주 나오기 때문이다.

1. Append는 합치기보다 이어붙이기다

많은 사용자가 Merge를 처음 쓸 때 기대하는 건 사실 Append에 가깝다. 왼쪽 입력 데이터 뒤에 오른쪽 입력 데이터를 그대로 이어 붙이는 구조다. 이 경우엔 두 입력의 아이템 수가 같을 필요도 없고, 키가 있어야 할 필요도 없다. 말 그대로 두 데이터셋을 한 줄로 이어붙이는 식이다.

그래서 Append는 “두 API 결과를 하나의 리스트로 만들고 싶다”거나, “서로 다른 경로의 같은 성격 데이터들을 합쳐 다음 단계로 넘기고 싶다”는 상황에 잘 맞는다. 반면 고객 정보와 주문 정보처럼 한 레코드로 정확히 엮어야 하는 상황엔 Append가 맞지 않는다. 이 점을 구분하지 않으면 Merge 노드가 기대와 다르게 보이기 쉽다.

2. Combine은 ‘어떤 기준으로 묶을지’가 핵심이다

원문에서 설명한 Position과 Key 기준 병합은 현재 문서 기준으로는 Combine 안의 일부 방식으로 보면 더 정확하다. Combine에는 Merge by Position, Merge by Matching Fields, Combine all possible combinations 같은 하위 방식이 있다. 특히 Matching Fields가 지금 문서 기준 표현에 더 가깝고, 예전 의미의 “Merge By Key”와 비슷한 개념으로 이해하면 된다.

즉, 지금의 핵심 질문은 이거다. “두 입력을 순서대로 믿고 붙일 것인가, 아니면 공통 필드 값을 기준으로 맞출 것인가?” 이 질문에 따라 결과는 완전히 달라진다. 실제로 실무에서는 순서를 끝까지 신뢰할 수 있는 데이터보다, 공통 키를 가진 데이터가 훨씬 많기 때문에 Matching Fields 쪽이 더 안전한 경우가 많다.

Merge By Position 순차적 병합

원문처럼 Position 방식은 가장 직관적이다. 첫 번째 입력의 첫 번째 아이템과 두 번째 입력의 첫 번째 아이템을 묶고, 두 번째와 두 번째를 묶는 식이다. 이 방식은 두 입력이 동일한 순서와 동일한 길이를 갖는다는 전제가 있어야만 믿고 쓸 수 있다. 실제로 이 전제가 조금만 어긋나도 결과는 금방 틀어진다.

예를 들어 CRM에서 고객 목록을 받고, 다른 쪽에서 같은 고객 목록의 이메일 발송 상태를 받았다고 해보자. 둘 다 같은 정렬 기준과 같은 필터를 거쳤다면 Position 방식이 자연스럽다. 하지만 한쪽에서 고객 한 명이 빠지거나, 정렬 순서가 살짝만 바뀌어도 이후 모든 매칭이 어긋난다. 이때부터는 눈으로 보기엔 합쳐진 것처럼 보여도, 실제론 전혀 다른 고객 정보끼리 붙고 있을 수 있다.

그래서 Position 방식은 빠르고 직관적이지만, 신뢰 조건이 매우 엄격하다고 보는 편이 낫다. “입력 데이터 수가 같아야 한다”는 원문 설명은 Merge 전체가 아니라, Position 방식에서 특히 중요하게 작동하는 규칙이라고 이해하면 더 정확하다.

3. Position 방식에서 자주 생기는 문제

가장 흔한 문제는 입력 데이터 개수 차이보다도, 중간 필터링 로직 불일치다. 예를 들어 왼쪽 경로에서는 비활성 사용자를 제외했는데, 오른쪽 경로에서는 그대로 두었다면 길이가 같더라도 순서 대응이 틀어질 수 있다. 즉 단순히 개수가 같다고 안전한 것도 아니다. 두 입력이 동일한 필터와 동일한 정렬 기준을 거쳤는지까지 같이 봐야 한다.

이 부분은 생각보다 자주 놓친다. 겉으로는 아이템 수가 같으니 문제없어 보이는데, 실제로는 3번째와 4번째 데이터가 서로 다른 사람을 가리키는 식이다. Position은 편하지만, 이 전제를 끝까지 관리할 수 있을 때만 써야 한다.

Merge By Matching Fields 공통 키를 활용한 정확한 병합

원문에서 설명한 “Merge By Key” 개념은 현재 공식 문서 기준으로는 Merge by Matching Fields로 보는 편이 더 정확하다. 왼쪽 입력과 오른쪽 입력에서 각각 비교할 필드를 지정하고, 값이 동일한 것끼리 매칭해 하나의 레코드로 합친다. 순서가 다르더라도 공통 식별자가 명확하면 정확하게 맞출 수 있다는 점이 가장 큰 장점이다.

예를 들어 왼쪽 입력엔 customerId, 오른쪽엔 id가 있고 둘이 같은 의미를 가진다면, Matching Fields에서 각각 그 필드를 지정해 병합할 수 있다. 이 방식은 순서에 덜 의존하므로 실무에서 훨씬 안전한 경우가 많다. 특히 외부 API 두 개 이상을 붙일 때는 순서보다 식별자가 더 신뢰할 만한 경우가 많기 때문이다.

다만 이 방식도 만능은 아니다. 키 값이 없거나 중복되면 결과가 기대와 다르게 나올 수 있다. 그래서 Merge 직전에는 키 필드가 실제로 존재하는지, 공백이 없는지, 중복 가능성이 없는지 먼저 확인하는 편이 좋다. 이 검증 한 번만 해도 나중에 헤매는 시간이 꽤 줄어든다.

4. Matching Fields가 더 안전한 상황

실무에서는 아래 같은 경우에 Matching Fields가 훨씬 낫다.

  • 두 입력의 정렬 기준이 확실하지 않을 때
  • 한쪽 입력에서 일부 아이템이 누락될 가능성이 있을 때
  • 외부 API 응답 순서를 끝까지 믿기 어려울 때
  • 고객 ID, 주문번호, 이메일처럼 비교 가능한 식별자가 있을 때

반대로 공통 식별자가 아예 없다면 Position이나 Append가 더 현실적일 수 있다. 결국 Merge는 “무슨 모드가 더 좋냐”보다, “지금 내 데이터에 어떤 기준이 실제로 존재하느냐”를 먼저 보는 쪽이 맞다.

실무에서 주의할 점과 해결책

Merge 노드는 잘만 쓰면 아주 유용하지만, 한 번 기준을 잘못 잡으면 워크플로우 전체 결과가 조용히 틀어질 수 있다. 이게 더 무섭다. 실패했다는 에러가 뜨는 게 아니라, 성공처럼 보이는데 데이터가 잘못 묶여 있을 수 있기 때문이다. 그래서 Merge 전후 검증이 특히 중요하다.

5. 중첩된 JSON 구조와 필드 충돌

원문처럼 두 입력 모두 status 같은 동일한 필드를 갖고 있으면, 병합 후 어떤 값이 남는지가 문제다. 현재 Merge 노드에서도 동일한 이름의 필드가 있으면 한쪽 값이 덮어쓸 수 있으므로, 충돌이 예상되는 필드는 Merge 전에 이름을 바꿔두는 편이 훨씬 안전하다. 예를 들어 왼쪽은 crm_status, 오른쪽은 payment_status처럼 나눠두면 병합 후 구조가 훨씬 읽기 쉬워진다.

실제로는 이 단순한 전처리 하나가 디버깅 시간을 많이 줄여준다. “왜 status가 이상하지?”를 뒤늦게 보는 것보다, 아예 의미가 드러나는 이름으로 정리하고 Merge하는 쪽이 훨씬 낫다.

6. Debug 노드보다 지금은 핀 데이터와 실행 디버깅이 더 현실적이다

원문에서는 “각 입력 경로마다 Debug 노드를 먼저 연결하라”는 표현이 나오는데, 현재 n8n 공식 문서 기준으로 별도의 Debug 노드를 중심으로 설명하는 흐름은 아니다. 대신 수동 실행, past executions 디버깅, 그리고 data pinning을 통해 입력 데이터를 고정하고 비교하는 방식이 더 현재 문서 기준에 가깝다. 즉 지금은 “Debug 노드를 넣는다”보다, Merge 직전 두 입력 노드의 출력 데이터를 각각 확인하고 필요하면 pinning 해서 비교한다는 식으로 이해하는 편이 더 정확하다.

실제로 이 방식이 더 편하다. 외부 API를 매번 다시 호출하지 않아도 되고, 두 입력의 구조를 고정한 상태에서 Merge 모드만 바꿔가며 비교할 수 있기 때문이다. 저도 지금은 이 방식을 더 자주 쓴다. 예전처럼 별도 디버그 흐름을 더 만드는 것보다, 같은 입력으로 Merge 설정만 바꿔보는 쪽이 훨씬 빠르게 감이 잡힌다.

병합 방식적용 조건주의사항
Append두 입력을 단순히 한 리스트로 이어 붙이고 싶을 때같은 레코드로 합쳐지는 것은 아님
Merge by Position입력 데이터 순서와 길이가 동일하게 관리될 때필터링, 정렬 차이만 생겨도 전체 매칭이 어긋날 수 있음
Merge by Matching Fields공통 식별자 필드가 존재하고 값 신뢰도가 높을 때키 누락, 중복, 빈값은 반드시 먼저 점검해야 함

📌 핵심 포인트 & 주의사항

Merge 노드는 “두 입력 아이템 수가 반드시 같아야만 작동한다”는 식으로 이해하면 현재 문서 기준과는 어긋날 수 있다. Position 방식에서는 길이와 순서가 매우 중요하지만, Matching Fields 방식은 공통 필드 값을 기준으로 병합한다. 실무에서는 순서보다 키를 더 신뢰할 수 있는 경우가 많으므로, 공통 식별자가 있다면 Matching Fields를 먼저 검토하는 편이 훨씬 안전하다. 또 Merge 전에는 각 입력 출력 데이터를 직접 확인하고, 가능하면 pinning 해둔 뒤 모드를 비교해보는 것이 가장 현실적인 검증 방법이다.

직접 확인해보면 좋은 테스트 예시

Merge 노드는 설명만 보면 쉬워 보여도, 실제로는 어떤 기준으로 붙는지 직접 확인해보는 편이 훨씬 도움이 된다. 아래처럼 일부러 자주 틀리는 구조를 만들어보면 Position과 Matching Fields 차이가 금방 체감된다.

1. Position 방식 어긋남 테스트

테스트 예시

입력 1:
[
 {"customerId": 1, "name": "Alice"},
 {"customerId": 2, "name": "Bob"}
]

입력 2:
[
 {"orderId": "A-100", "customerId": 2},
 {"orderId": "A-101", "customerId": 1}
]

기대 결과
Position으로 병합하면 순서대로 묶여 고객과 주문이 엇갈릴 수 있다.

실제 확인 포인트
Matching Fields로 customerId를 기준으로 바꿨을 때 결과가 바로 정상화되는지 비교한다.

2. 동일 필드명 충돌 테스트

테스트 예시

입력 1:
{"status": "crm_active"}

입력 2:
{"status": "payment_pending"}

기대 결과
병합 후 status 필드 하나만 남아 의미가 흐려질 수 있다.

실제 확인 포인트
Merge 전에 Set/Edit Fields로 필드명을 바꿨을 때 결과 구조가 얼마나 읽기 쉬워지는지 확인한다.

3. Append와 Combine 비교 테스트

테스트 예시

입력 1:
[{"id":1},{"id":2}]

입력 2:
[{"id":3},{"id":4}]

기대 결과
Append는 4개 아이템이 이어붙은 결과가 되고, Combine은 어떤 기준으로 조합할지에 따라 전혀 다른 결과가 나온다.

실제 확인 포인트
“합쳤다”는 말이 실제로는 이어붙였는지, 한 레코드로 묶었는지 구분해서 확인한다.

4. 핀 데이터 기반 병합 검증 테스트

테스트 예시

입력 1과 입력 2를 각각 pinning
Merge 노드에서 Position ↔ Matching Fields 전환

기대 결과
같은 입력으로 Merge 기준만 바꿨을 때 어떤 방식이 현재 데이터 구조에 맞는지 금방 드러나야 한다.

실제 확인 포인트
외부 API를 다시 호출하지 않고도 병합 기준을 반복 비교할 수 있는지 확인한다.

실제 검증 실행 결과

실제 검증 기준으로 보면, 가장 먼저 차이가 난 건 데이터 수보다도 “순서를 얼마나 신뢰할 수 있느냐”였다. 같은 개수라도 정렬 기준이 다르면 Position 방식은 조용히 엉뚱한 레코드를 붙였고, Matching Fields로 customerId를 맞춘 뒤에야 기대한 결과가 나왔다. 또 status처럼 같은 이름 필드가 있을 때는 Merge 자체보다 병합 전 필드명 정리가 훨씬 중요했다. 그리고 별도 Debug 노드를 늘리기보다 pinning 한 상태에서 Merge 모드만 바꿔보는 쪽이 훨씬 빠르게 감이 왔다. 결국 Merge 노드는 “어떻게 합칠까”보다 “무엇을 기준으로 믿고 합칠까”가 더 중요한 노드라는 점이 가장 크게 체감됐다.

Merge 노드는 데이터 결합 기준이 조금만 어긋나도 결과가 조용히 틀어질 수 있어서, 실제 운영 환경에서 재검증 구조를 같이 잡는 편이 좋다. 구조 관리 관점에서는 [관련 글: n8n Git 연동으로 워크플로우 버전 관리 시스템 구축하기 더 알아보기]와 [관련 글: n8n NAS 설치 Docker로 자동화 서버 구축하기 더 알아보기]를 같이 보면 도움이 된다.

FAQ: 자주 묻는 질문

Q. n8n Merge 노드로 3개 이상의 데이터 흐름을 합칠 수 있나요?

A. Merge 노드는 한 번에 두 입력을 받는다. 하지만 첫 번째 Merge 결과를 다시 다른 Merge 노드에 넣는 식으로 3개 이상도 순차적으로 결합할 수 있다. 다만 입력 구조와 병합 기준이 단계마다 달라질 수 있으므로, 각 단계의 기준을 명확히 나누는 편이 안전하다.

Q. 병합 후 중복 필드는 어떻게 처리되나요?

A. 같은 이름의 필드가 있으면 결과에서 한쪽 값이 다른 쪽 값을 덮어쓸 수 있다. 이걸 피하려면 Merge 전에 Edit Fields (Set) 노드로 필드명을 다르게 바꿔두는 것이 가장 현실적이다.

Q. Merge 노드 대신 Function 노드로 직접 병합하는 게 더 낫지 않나요?

A. 현재 문서 기준으로는 Function 노드보다 Code 노드 표현이 더 정확하다. 단순 병합이라면 Merge 노드가 더 읽기 쉽고 유지보수에도 유리하다. 배열 조작이나 특수한 커스텀 병합 로직이 아주 복잡한 경우에만 Code 노드를 검토하는 편이 일반적이다.


n8n Merge 노드는 자동화에서 마지막 퍼즐 조각을 맞추는 노드처럼 보이지만, 실제로는 퍼즐 조각을 어떤 기준으로 맞출지 정하는 노드에 더 가깝다. 그래서 합쳐졌는가보다, 올바른 기준으로 합쳐졌는가를 먼저 봐야 한다.

독자 입장에서 바로 체감되는 이득도 분명하다. Position과 Matching Fields 차이만 정확히 이해해도 엉뚱한 데이터 조합을 훨씬 덜 보게 된다. 결국 자동화의 품질은 데이터가 “들어왔는가”보다 “정확히 연결됐는가”에서 크게 갈린다.

직접 여러 번 써보니, Merge 노드는 쉬운 노드가 아니라 쉬워 보여서 더 자주 실수하는 노드에 가까웠다. 하지만 기준만 제대로 잡으면, 분리된 데이터를 다시 의미 있는 정보로 묶어주는 아주 강력한 도구가 된다.

실제로 적용할 때 체크할 부분

이 글을 읽고 바로 적용해보려면 먼저 지금 Merge 노드를 쓰는 워크플로우 하나를 열어, 현재 모드가 Position인지 Matching Fields인지부터 확인하는 것이 좋다. 그다음 두 입력의 출력 구조를 각각 보고, 정말 순서를 믿을 수 있는지, 아니면 공통 키가 있는지를 먼저 판단하면 된다.

다음 단계 학습용으로는 [관련 글: n8n Git 연동으로 워크플로우 버전 관리 시스템 구축하기 더 알아보기], [관련 글: n8n NAS 설치 Docker로 자동화 서버 구축하기 더 알아보기], [관련 글: n8n 구글클라우드로 평생 무료 운영하는 실전 가이드 더 알아보기], [관련 글: n8n oracle cloud 무료 서버 설치 가이드 더 알아보기]를 순서대로 같이 보면 운영과 배포 감각까지 함께 잡기 좋다.

그리고 가능하다면 입력 데이터를 pinning 한 상태에서 Merge 모드만 바꿔가며 결과를 비교해보는 것이 좋다. 같은 입력으로 Merge 기준만 바꿔보면, 어떤 방식이 현재 데이터 구조에 맞는지 훨씬 빨리 감이 잡힌다.


참고 자료: n8n 공식 문서 – Merge 노드 | n8n 공식 문서 – Merging and splitting data | n8n 공식 문서 – Data pinning | n8n 공식 문서 – Code 노드

Merge 노드는 데이터를 단순히 붙이는 노드가 아니라, 어떤 기준으로 같은 항목으로 볼지를 정하는 단계에 가깝다. 그래서 이 글도 단순 기능 소개보다, 실제로 다시 손댈 때 바로 체크할 수 있는 기준이 남도록 흐름을 정리하는 쪽이 더 유용하다.

Eddy Glen
Eddy Glen

Eddy Glen은 n8n 자동화와 워드프레스 연동, API 기반 업무 자동화를 중심으로 콘텐츠를 운영합니다. 이 사이트에서는 설치, 업데이트, 오류 해결, 실전 적용 과정에서 자주 막히는 지점을 중심으로 글을 정리하며, 공식 문서와 실제 적용 흐름을 함께 검토해 내용을 구성합니다.

기사 : 72

댓글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다