SVN 프로젝트 merge 충돌 10분 만에 해결하는 실전 전략

2026-06-11 · Uncategorized · 읽는데 18분

SVN 프로젝트 merge 충돌 10분 만에 해결하는 실전 전략

썸네일

브랜치 전략의 함정, 나도 당했다

작년 여름이었다. 금요일 오후 5시, 딱 퇴근하려는 찰나에 팀장님이 다급하게 전화를 걸어왔다.

"야, trunk에 branch 합치는 중인데 파일 47개에서 충돌 났어. 내일까지 배포해야 하는데 어떡하지?" 그날 나는 밤 11시까지 회사에 남아 충돌 파일 하나하나를 손으로 고쳐야 했다. 그 경험 이후로 나는 SVN merge 충돌에 대해 진지하게 공부하기 시작했다.

SVN을 사용하는 개발자라면 누구나 한 번쯤 겪는 이 고통. 사실 충돌 자체는 나쁜 게 아니다. 충돌은 두 명 이상의 개발자가 같은 파일을 동시에 수정했다는 신호일 뿐이다.

문제는 그 충돌을 어떻게 효율적으로 해결하느냐에 달려 있다. 내가 경험한 바로는, 대부분의 충돌은 예방 가능하고, 발생하더라도 올바른 도구와 순서만 알면 10분 안에 해결할 수 있다.

SVN을 8년간 사용해오면서 내린 결론은 이렇다. merge 충돌의 80%는 작업 순서를 잘못 잡았거나, 브랜치 간 동기화를 게을리해서 발생한다.

나머지 20%는 운이 나쁘거나 구조적인 설계 문제다. 이 글에서는 그 80%를 어떻게 없앨 수 있는지, 그리고 남은 20%를 어떻게 10분 만에 처리할 수 있는지 구체적으로 풀어보겠다.

merge 충돌의 진짜 원인

많은 개발자들이 충돌을 단순히 "같은 파일을 동시에 수정해서" 발생한다고 생각한다. 하지만 실제로는 더 복잡하다.

SVN의 merge 메커니즘은 단순히 파일을 비교하는 수준이 아니라, 파일 내의 특정 라인이 어느 revision에서 변경되었는지를 추적한다. 이게 바로 svn:mergeinfo 속성의 핵심이다.

한 예를 들어보자. A와 B 두 개발자가 같은 파일의 다른 부분을 수정했다면? SVN은 이걸 자동으로 합쳐준다. 충돌이 발생하는 진짜 조건은 다음과 같다:

조건 설명 발생 확률
같은 라인 수정 두 브랜치에서 동일한 코드 라인을 다르게 변경 45%
인접 라인 수정 변경된 코드가 서로 붙어있거나 연관됨 30%
파일 삭제 충돌 한쪽에서 삭제하고 다른 쪽에서 수정 15%
속성 충돌 파일 권한, 줄바꿈 방식 등 메타데이터 충돌 10%

내 경험상 "같은 라인 수정"이 가장 흔하면서도 해결하기 까다롭다. 특히 if문이나 함수 시그니처 같은 중요한 부분에서 충돌이 나면, 단순히 코드를 합치는 게 아니라 로직 자체를 재검토해야 하는 상황이 온다.

IDE별 충돌 해결 도구의 진실

Eclipse, IntelliJ, Visual Studio. 세 가지 IDE에서 SVN을 사용해본 입장으로서 말하자면, 충돌 해결 도구의 편의성은 천지차이다. 각 IDE마다 장단점이 뚜렷해서, 프로젝트 성격에 따라 선택해야 한다.

Eclipse 가장 직관적이지만 무거운

Eclipse의 Team > Synchronize with Repository 기능은 정말 편리하다. 충돌이 발생한 파일을 시각적으로 보여주고, Override and Commit, Override and Update, Mark as Merged 세 가지 옵션을 제공한다.

여기서 중요한 건 Mark as Merged다. 이 옵션은 수동으로 충돌을 해결한 후 "내가 다 고쳤다"고 SVN에 알려주는 기능이다.

실제로 파일을 열어서 conflict marker(>>>>>, <<<<<, =====)를 직접 수정한 다음, 이 옵션을 선택하면 commit이 가능해진다. 하지만 Eclipse의 치명적인 단점은 프로젝트가 커질수록 Synchronize 화면을 띄우는 속도가 터무니없이 느려진다는 점이다.

우리 팀은 50만 라인 규모의 프로젝트를 Eclipse로 관리했는데, Synchronize 한 번 하면 커피 한 잔 마실 시간이 생겼다.

IntelliJ 가볍지만 학습 곡선이 있는

IntelliJ는 SVN 플러그인이 내장되어 있어서 Eclipse보다 가볍다. Subversion > Integrate Directory 기능으로 merge를 수행하는데, 여기서 충돌이 발생하면 자체 merge tool이 열린다.

IntelliJ merge tool의 강점은 세 가지 패널을 동시에 보여준다는 점이다. 왼쪽에는 내 로컬 파일, 오른쪽에는 서버 파일, 중앙에는 merge 결과가 표시된다.

각 패널에서 수용할 코드를 클릭만 하면 자동으로 중앙 패널에 반영된다. 단점은? 처음 사용할 때 인터페이스가 직관적이지 않다는 점이다.

Eclipse의 Mark as Merged처럼 "Resolve" 버튼이 어디 있는지 찾느라 시간을 낭비하는 개발자들을 많이 봤다.

Visual Studio + AnkhSVN 안정적이지만 기능이 제한적

Visual Studio에서 SVN을 사용하려면 AnkhSVN이나 VisualSVN 같은 확장 기능이 필요하다. AnkhSVN은 무료지만 기능이 제한적이다.

특히 merge two different trees와 merge a range of revisions의 차이를 이해하지 못하면 큰 낭패를 본다. 실제로 한 팀원이 AnkhSVN의 merge two different trees 옵션을 사용했다가 trunk의 기존 코드가 모두 사라지고 branch 코드만 남는 사태가 발생했다.

이유는 간단했다. merge two different trees는 두 개의 독립적인 트리를 병합하는 기능이지, branch를 trunk에 통합하는 기능이 아니었다.

IDE 충돌 해결 편의성 대규모 프로젝트 성능 학습 곡선
Eclipse 상 (Mark as Merged) 하 (느림) 중
IntelliJ 상 (3-panel merge) 중 상
Visual Studio 중 (AnkhSVN 기준) 상 하

다른 내용도 보러가기 #1

merge 순서가 모든 것을 결정한다

여기서 가장 중요한 이야기를 해보겠다. SVN merge의 성패는 순서에 달려 있다.

많은 개발자들이 trunk에서 branch를 만들고, branch에서 작업한 후 바로 trunk로 merge하려고 한다. 이게 바로 충돌 지옥의 시작이다.

올바른 merge 순서

올바른 순서는 이렇다:

  1. branch에서 trunk를 먼저 merge한다 (Merge a range of revisions)
  2. 충돌을 해결하고 branch에 commit한다
  3. 그 다음에 trunk에서 branch를 merge한다 (Reintegrate branch)

왜 이 순서가 중요할까? trunk에는 branch를 만든 이후에도 다른 팀원들이 계속 코드를 추가하고 있다. 이 trunk의 최신 변경사항을 branch에 먼저 적용하지 않은 상태에서 branch를 trunk로 merge하면, trunk의 변경사항이 유실될 위험이 크다.

실제 사례를 들어보겠다. 우리 팀에서 A 개발자는 branch에서 로그인 기능을 고치고 있었고, B 개발자는 trunk에서 결제 모듈을 수정하고 있었다.

두 작업은 전혀 다른 파일이었지만, 문제는 공통 라이브러리를 사용했다는 점이다. A 개발자가 branch에서 공통 라이브러리의 버전을 올렸는데, B 개발자는 trunk에서 예전 버전을 기준으로 코드를 작성했다.

이 상황에서 A 개발자가 바로 trunk로 merge했다면? trunk의 결제 모듈이 깨졌을 것이다. 하지만 A 개발자가 먼저 trunk의 최신 변경사항을 branch로 가져와서 충돌을 해결한 후, trunk로 merge했다면? 아무 문제 없이 통합될 수 있었다.

merge type 선택의 함정

TortoiseSVN의 merge type 선택 화면을 보면 세 가지 옵션이 있다:

  • Merge a range of revisions: 특정 revision 구간의 변경사항만 merge
  • Reintegrate a branch: branch의 모든 변경사항을 trunk로 통합
  • Merge two different trees: 두 개의 독립적인 트리 병합

많은 초보자들이 "Merge two different trees"를 선택하는 실수를 한다. 이 옵션은 branch와 trunk의 관계가 아닌, 완전히 별개의 두 프로젝트를 합칠 때 사용하는 기능이다.

이걸로 branch를 trunk에 합치면, trunk의 독자적인 변경사항이 모두 사라질 위험이 있다. SVN 1.7 이전 버전에서는 Reintegrate a branch 옵션을 명시적으로 선택해야 했지만, 1.8 이후부터는 SVN이 자동으로 감지한다.

하지만 여전히 많은 조직이 SVN 1.6이나 1.7을 사용하고 있어서, 이 차이를 모르면 큰 문제가 생긴다.

merge type 사용 상황 위험도
Merge a range of revisions 특정 기능만 branch에 반영 낮음 (선택적)
Reintegrate a branch branch 전체를 trunk로 통합 중간 (순서 중요)
Merge two different trees 독립적인 두 프로젝트 병합 높음 (잘못 사용 시)

충돌 발생 시 10분 해결 프로세스

자, 이제 실제로 충돌이 발생했을 때 어떻게 10분 안에 해결할 수 있는지 단계별로 설명하겠다. 이 프로세스는 내가 수백 번의 merge를 겪으면서 정립한 방법이다.

1단계 충돌 파일 목록 파악 (1분)

가장 먼저 해야 할 일은 충돌이 발생한 파일이 몇 개인지, 어떤 파일인지 파악하는 것이다. SVN은 충돌이 발생한 파일 옆에 'C' 표시를 붙여준다.

이 파일들을 한눈에 볼 수 있도록 IDE의 Synchronize 화면이나 svn status 명령어를 사용하자.

svn status 결과에서 충돌 파일은 첫 글자가 'C'로 표시된다. 이 파일들을 모아서 우선순위를 정해야 한다.

핵심 로직 파일이 충돌났다면 먼저 해결하고, 주석이나 문서 파일은 나중에 처리해도 된다.

2단계 충돌 원인 분석 (3분)

각 충돌 파일을 열어서 어떤 부분에서 충돌이 발생했는지 확인한다. SVN은 충돌 부분에 다음과 같은 마커를 삽입한다:

``` <<<<<<< .working // 내가 수정한 코드 ======= // 서버의 최신 코드

.merge-right.r1234 ```

이 마커 사이의 코드를 보고 판단해야 한다. 여기서 세 가지 경우가 있다:

  1. 단순 중복: 두 코드가 논리적으로 동일한데 표현만 다른 경우 → 아무거나 선택
  2. 상호 보완: 두 코드가 각각 다른 기능을 추가한 경우 → 두 코드를 모두 유지
  3. 충돌: 두 코드가 같은 기능을 다르게 구현한 경우 → 논리적 검토 필요

실제 프로젝트에서 가장 많이 발생하는 건 1번과 2번이다. 3번은 드물지만 발생하면 개발자 간 논의가 필요하다.

3단계 실제 해결 (5분)

충돌 해결 방법은 상황에 따라 다르다. 내 경험상 가장 효율적인 방법은 다음과 같다:

  • 단순 충돌: IDE의 merge tool을 사용해 클릭 몇 번으로 해결
  • 복잡 충돌: 수동으로 코드를 편집한 후 Mark as Merged 또는 Resolve 처리

여기서 중요한 건 "과감함"이다. 충돌이 발생한 코드 중 하나를 선택하고, 나머지는 버려야 한다.

양쪽 다 유지하려고 하다 보면 코드가 지저분해지고, 나중에 더 큰 문제가 생긴다.

4단계 검증 (1분)

충돌을 해결한 후에는 반드시 빌드가 되는지 확인해야 한다. 충돌 해결 과정에서 문법 오류가 발생할 수 있기 때문이다.

IDE에서 빌드하거나 svn build 명령어를 실행하자.

만약 빌드가 실패한다면? 다시 2단계로 돌아가서 충돌 해결을 다시 해야 한다. 이 과정이 귀찮다고 무시하면, 나중에 QA 단계에서 더 큰 문제로 돌아온다.

단계 소요 시간 핵심 작업 주요 도구
파일 파악 1분 충돌 파일 목록 확인 svn status, IDE Synchronize
원인 분석 3분 충돌 마커 확인 및 판단 IDE merge tool, diff tool
실제 해결 5분 코드 수정 및 Resolve 수동 편집, merge tool
검증 1분 빌드 확인 IDE build, CI 도구

실무에서 겪은 생생한 사례들

이론만으로는 실제 상황을 완벽히 대비할 수 없다. 내가 직접 겪었던 몇 가지 사례를 공유하겠다.

사례 1 병합 순서를 잘못 잡아서 프로젝트가 통째로 롤백된 경우

한 스타트업에서 프리랜서로 일할 때였다. 주니어 개발자가 branch에서 2주 동안 작업한 내용을 trunk로 merge했다.

그런데 trunk의 기존 코드가 모두 사라지고 branch 코드만 남는 사태가 발생했다. 원인은 간단했다.

그 개발자가 "Merge two different trees" 옵션을 사용했고, trunk를 source로, branch를 target으로 설정했기 때문이다. 이 경우 trunk의 모든 변경사항이 branch로 덮어씌워진다.

해결 방법은? 다행히 SVN은 merge 전의 revision을 기억하고 있어서, svn merge --revision HEAD:PREV 명령어로 롤백할 수 있었다. 하지만 그동안 다른 팀원들이 trunk에 commit한 변경사항은 모두 유실되었다.

이 경험 이후로 우리 팀은 merge 전에 반드시 코드 리뷰를 받도록 규칙을 정했다. 또한 merge 스크립트를 만들어서 잘못된 명령어를 사용할 가능성을 원천 차단했다.

사례 2 충돌 해결 후에도 빌드가 안 되는 경우

얼마 전 우리 팀에서 있었던 일이다. 충돌을 모두 해결하고 merge를 완료했는데, 빌드가 실패했다.

이유는? 충돌 해결 과정에서 import 문이 중복으로 추가되었기 때문이다. A 개발자는 branch에서 import java.util.List;를 추가했고, B 개발자는 trunk에서 같은 파일에 import java.util.ArrayList;를 추가했다.

충돌이 발생하자, 두 import 문을 모두 유지했다. 그런데 원래 파일에 이미 import java.util.*;가 있었다.

결과적으로 중복 import로 인해 컴파일 경고가 발생했고, 우리 팀의 CI 서버는 경고를 에러로 처리하도록 설정되어 있어서 빌드가 실패했다. 이런 경우를 방지하려면, 충돌 해결 후에 반드시 svn diff 명령어로 변경사항을 검토하는 습관을 들여야 한다.

다른 내용도 보러가기 #2

마치며 충돌을 두려워하지 말자

SVN merge 충돌은 개발자의 숙명이다. 하지만 잘못된 도구나 순서로 인해 발생하는 충돌은 대부분 예방할 수 있다.

핵심은 다음과 같다:

  1. merge 순서를 지켜라: branch → trunk 순서가 아니라 trunk → branch → trunk 순서
  2. merge type을 정확히 선택하라: Reintegrate a branch가 기본, Merge two different trees는 특수한 경우만
  3. 충돌이 발생하면 침착하게 10분 프로세스를 따라라
  4. merge 전에는 반드시 두 브랜치 모두 commit된 상태인지 확인하라

사실 SVN을 오래 사용하다 보면, Git에 비해 merge가 더 까다롭다는 걸 느낀다. Git은 분산 버전 관리 시스템이라 로컬에서 merge를 시도해볼 수 있지만, SVN은 중앙 집중식이라 실수가 바로 서버에 반영된다.

따라서 SVN을 사용한다면 더 신중하게 작업해야 한다. 하지만 SVN의 장점도 있다.

학습 곡선이 Git보다 낮고, 대규모 바이너리 파일 관리에 강점이 있다. 특히 게임 개발이나 CAD 파일을 다루는 업계에서는 SVN이 여전히 많이 사용된다.

여러분의 프로젝트에서는 어떤 merge 전략을 사용하고 있나요? 혹시 이 글에서 다루지 않은 특별한 노하우가 있다면, 다음 글에서 함께 나누면 좋겠다.

관련 영상

같이 보면 좋은 글