SVN merge 충돌, commit 거부될 때 update부터 해야 하는 이유

2026-09-16 · 테크 · 읽는데 7분

SVN merge 충돌, commit 거부될 때 update부터 해야 하는 이유

SVN에서 merge 충돌은 같은 파일의 같은 부분을 두 사람 이상이 각각 수정한 뒤 저장소에 반영하려 할 때 발생합니다. 충돌 자체는 오류가 아니라 SVN이 "이 두 변경을 자동으로 합칠 수 없다"고 판단한 신호이며, 작업 복사본에서 직접 어느 쪽 내용을 남길지 정해 주면 해결됩니다. 반대로 그림 파일처럼 줄 단위 병합이 불가능한 바이너리 파일은 충돌이 나면 자동 해결이 사실상 어렵기 때문에, 애초에 lock을 걸어 두는 편이 안전합니다.

SVN merge 충돌은 언제 터지는가

Subversion은 기본적으로 locking을 선호하지 않는 시스템입니다. 두 사람이 같은 파일의 같은 버전에서 같은 부분을 수정할 확률이 높지 않다고 보기 때문입니다. 그래서 별도 잠금 없이 각자 수정하고 commit하는 방식을 기본으로 둡니다.

문제는 파일 크기가 크지 않을 때입니다. 파일이 작으면 누가 수정하든 비슷한 위치에서 손이 가기 때문에 충돌 가능성이 오히려 높아집니다. 여기에 더해 그림 파일처럼 merge 자체가 곤란한 형식은 자동 병합이 안 되므로 lock을 거는 쪽이 훨씬 안전합니다.

충돌이 실제로 드러나는 시점은 commit 단계입니다. 누군가 먼저 commit해서 revision이 올라가면, 아직 update하지 않은 작업 복사본의 Base revision과 저장소의 Head revision이 어긋나게 됩니다. 이 상태에서 commit을 시도하면 거부되고, update를 먼저 수행하라는 안내를 받게 됩니다.

핵심 개념을 정리하면 다음과 같습니다.

  • Revision: 저장소에 변경이 반영될 때마다 하나씩 증가하는 번호
  • Head: 저장소에 저장된 가장 최근 commit된 revision
  • Base: 클라이언트가 checkout·update로 내려받은 revision
  • Conflict: 같은 파일의 같은 부분을 여러 사용자가 수정한 뒤 반영하려 할 때 발생
  • Merge: branch로 분리된 소스의 변경 내용을 현재 작업에 합치는 작업

Head와 Base가 어긋날 때 벌어지는 일

충돌의 출발점은 Head와 Base의 불일치입니다. 내가 update한 뒤 소스를 수정하고 있는 사이에 다른 사람이 commit하면, Head는 그 사람의 revision이 되고 내 작업 복사본은 이전 revision에 머무릅니다. 이때 Head와 Base가 다르면 commit이 거부되고 update를 먼저 해야 합니다.

update를 수행하면 SVN이 두 변경을 비교해 자동으로 합칠 수 있는 부분은 합치고, 합칠 수 없는 부분만 충돌로 표시합니다. 즉 충돌은 update 시점에 표면화되는 경우가 많습니다.

Head와 Base가 어긋날 때 벌어지는 일
Head와 Base가 어긋날 때 벌어지는 일
구분 의미
Head 저장소 최신 commit
Base 내가 받은 revision
불일치 시 commit 거부, update 필요

lock으로 충돌을 미리 막는 방법

바이너리 파일이나 충돌 위험이 큰 파일은 lock을 걸어 두는 것이 실질적인 예방책입니다. Harry가 어떤 파일을 lock하면 Sally는 그 파일을 checkout하거나 update받을 수는 있지만 commit은 할 수 없습니다. Harry가 lock을 풀면 그때부터 Sally가 다시 commit할 수 있습니다.

lock은 svn lock 명령으로 걸고, 해제는 svn unlock으로 합니다. 왜 파일에 lock을 걸었는지 로그로 기록할 수도 있어서, 팀 단위로 이유를 공유하기에 적합합니다.

lock으로 충돌을 미리 막는 방법
lock으로 충돌을 미리 막는 방법
명령 동작
svn lock 파일 잠금
svn unlock 잠금 해제
svn update 최신 소스 반영
svn commit 변경 사항 저장

충돌이 났을 때 실제로 따라 하는 순서

충돌을 발견한 뒤의 대응은 다음 순서로 진행합니다.

  1. svn update로 저장소의 최신 revision을 작업 복사본에 반영합니다.
  2. 충돌 표시가 붙은 파일을 열어 어느 쪽 내용을 남길지 판단합니다.
  3. 양쪽 변경을 모두 살릴지, 한쪽만 남길지 결정해 파일을 정리합니다.
  4. 정리한 파일을 충돌 해결 상태로 표시합니다.
  5. svn commit으로 다시 저장소에 반영합니다.

여기서 중요한 점은 commit 전에 반드시 update를 한 번 거치는 습관입니다. 소스를 수정하거나 commit하기 전에 update를 해 두면, 충돌이 커지기 전에 미리 확인할 수 있습니다.

branch 작업 후 trunk로 합칠 때 주의할 점

프로젝트 소스는 SVN 서버의 trunk에 위치하고, 개발자는 trunk 소스를 내려받아 수정한 뒤 다시 올리는 방식으로 작업합니다. 다른 개발자들과 떨어져서 작업하려면 branches 디렉토리 안에 별도 디렉토리를 만들어 branch를 생성하고, 완성되면 Merge 기능으로 trunk와 합칩니다.

이때 trunk 쪽에서도 그 사이에 변경이 쌓여 있으면 merge 과정에서 충돌이 생길 수 있습니다. tag는 버전별 배포판이나 안정화된 소스를 따로 보관하는 공간으로, 특정 시점의 스냅샷을 남겨 두는 용도입니다. trunk·branches·tags의 역할을 구분해 두면 merge 범위를 좁히는 데 도움이 됩니다.

branch 작업 후 trunk로 합칠 때 주의할 점
branch 작업 후 trunk로 합칠 때 주의할 점
디렉토리 용도
trunk 중심 개발 소스
branches 분리 개발
tags 버전별 보관

자주 묻는 질문

Q. 충돌이 나면 무조건 수동으로 고쳐야 하나요?

줄 단위로 비교 가능한 텍스트 파일은 SVN이 자동으로 합칠 수 있는 부분을 먼저 병합합니다. 사람이 판단해야 하는 부분만 충돌로 남기 때문에, 표시된 구간만 정리하면 됩니다. 반면 그림 파일처럼 merge가 곤란한 형식은 자동 병합이 되지 않아 lock으로 사전 차단하는 편이 낫습니다.

Q. commit이 거부되는 이유는 무엇인가요?

Head와 Base가 다르기 때문입니다. 내가 받은 revision 이후에 다른 사람이 commit해 저장소가 앞서 나간 상태이므로, update로 최신 소스를 반영한 뒤 다시 commit해야 합니다.

Q. SVN이 Git보다 충돌 관리에 불리한가요?

SVN은 중앙 집중식 버전 관리 도구로, 대용량 파일이 포함된 프로젝트에서 유용합니다. 다만 Git 같은 분산형 도구에 비해 유연성이 떨어지고 충돌 관리나 속도 측면에서 약점이 있습니다. 개발자가 자신만의 버전 이력을 독립적으로 가질 수 없다는 점도 차이입니다.

Q. lock을 걸어 두면 충돌이 아예 안 생기나요?

lock이 걸린 파일은 다른 사람이 commit할 수 없으므로 해당 파일에서는 충돌이 발생하지 않습니다. 다만 lock을 걸지 않은 나머지 파일에서는 여전히 충돌 가능성이 남아 있어, 작업 전 update 습관과 함께 운용하는 것이 일반적입니다.