깃(Git) 푸시 후 "머지할 내용이 없다"는 황당 메시지, 왜 그럴까?

 

깃(Git) 머지 리퀘스트, "머지할 내용이 없다"고 나올 때? 🤔

깃(Git)으로 작업하다 보면 가끔 당황스러운 메시지를 마주칠 때가 있죠. 커밋(commit)하고 푸시(push)까지 다 했는데, 머지 리퀘스트(Merge Request, 또는 Pull Request)를 날리니 "머지할 내용이 없다"는 메시지가 뜬금없이 나타나는 경우가 있습니다. 분명히 열심히 코드를 짰는데, 깃은 왜 이런 반응을 보일까요? 오늘은 이 미스터리한 상황의 원인과 해결 방법을 알아보겠습니다.

---

"머지할 내용이 없다"(There isn't anything to compare) 메시지가 뜨는 이유

이 메시지가 나타나는 주요 원인은 다음과 같습니다.

1. 이미 대상 브랜치에 반영된 내용일 경우 🔄

가장 흔한 경우입니다. 여러분이 작업한 내용이 이미 대상 브랜치 (예: main 또는 develop)에 포함되어 있다는 뜻이죠.

• 다른 MR을 통해 이미 머지됨: 동료가 같은 기능 작업을 먼저 완료하고 머지 리퀘스트를 날려 승인된 경우, 여러분의 작업 내용이 대상 브랜치에 이미 들어갔을 수 있습니다.
• 로컬 브랜치 업데이트 누락: 여러분이 피처 브랜치를 만들 때, 대상 브랜치(예: main)를 최신 상태로 업데이트하지 않고 작업했을 수 있습니다. 그 사이에 다른 변경 사항이 main 브랜치에 직접 푸시되거나 다른 MR을 통해 머지되면서, 여러분의 커밋 내용이 의도치 않게 main에 먼저 포함된 것이죠.
• Rebase 후 기존 MR 요청: rebase 명령어로 커밋 히스토리를 변경한 후, 기존 커밋을 포함하는 브랜치로 다시 MR을 요청했을 때도 발생할 수 있습니다.

2. 대상 브랜치를 잘못 선택한 경우 🏷️

머지 리퀘스트를 생성할 때 대상 브랜치를 잘못 지정했을 가능성도 있습니다. 예를 들어 feature-A 브랜치 내용을 main에 머지해야 하는데, 실수로 feature-A를 다시 feature-A에 머지하려 시도했거나, 이미 모든 내용이 포함된 다른 브랜치로 지정했을 수 있습니다.

3. Squash Merge 전략의 영향 🧺

만약 프로젝트에서 "Squash and Merge" 전략을 사용하고 있다면, 이전에 비슷한 내용으로 스쿼시 머지가 이루어진 적이 있을 때 깃이 새로운 변경 사항이 없다고 판단할 수 있습니다. 스쿼시 머지는 여러 커밋을 하나의 커밋으로 압축하기 때문에, 원본 커밋들과 대상 브랜치 간의 직접적인 연결이 끊어질 수 있습니다.

4. git revert로 변경 사항이 취소된 경우 ↩️

여러분이 특정 커밋을 날렸지만, 이후 어떤 이유로 해당 커밋 내용이 git revert 명령어를 통해 취소(되돌리기)되었을 수 있습니다. revert는 기존 커밋을 없애는 것이 아니라, 그 커밋의 변경 사항을 되돌리는 새로운 커밋을 생성합니다. 따라서 피처 브랜치에 남아있는 커밋 내용이 이미 대상 브랜치에서는 revert되어 더 이상 새로운 변경 사항으로 인식되지 않을 수 있습니다.

5. 브랜치 기록이 꼬인 경우 (Force Push 등) ⚠️

git push --force와 같은 명령어로 원격 브랜치의 기록을 강제로 덮어썼을 때, 깃 히스토리가 복잡해지면서 이런 문제가 발생할 수 있습니다. 특히 여러 사람이 함께 작업하는 브랜치에서는 force push 사용에 신중해야 합니다.

6. 실제로 커밋이 누락된 경우 🤷‍♀️

간혹 git add만 하고 git commit을 하지 않았거나, git commit은 했지만 git push를 깜빡한 상태에서 머지 리퀘스트를 생성하는 경우도 있습니다.

---

GitHub에서는 어떤 메시지가 표시될까? 💬

그렇다면 실제로 GitHub 같은 플랫폼에서는 이 상황을 어떻게 보여줄까요?

가장 흔하게 볼 수 있는 메시지는 "There isn't anything to compare." 입니다. 이는 PR을 생성하려고 할 때, 소스 브랜치(헤드 브랜치)와 대상 브랜치(베이스 브랜치) 사이에 비교할 만한 차이가 없다는 의미를 명확히 전달합니다.

또한, 이미 생성된 Pull Request 페이지에서는 다음과 같은 시각적 단서를 통해 "머지할 내용이 없음"을 알 수 있습니다.

• "Files changed" 탭이 비어있음: 가장 확실한 지표입니다. 분명히 코드를 수정했지만, 이 탭에 아무런 파일 변경 내용도 표시되지 않는다면, 깃허브는 두 브랜치 간의 실질적인 차이를 인지하지 못하고 있다는 뜻입니다.
• "Conversation" 탭의 머지 버튼 영역: "Merge pull request" 버튼이 비활성화되어 있거나, 활성화되어 있더라도 해당 영역에 "This branch has no conflicts with the base branch"와 같은 메시지만 표시되고 새로운 변경사항이 보이지 않을 수 있습니다.

---

"머지할 내용이 없다" 메시지 해결 방법

문제가 발생했을 때 다음 단계들을 확인하며 해결해 볼 수 있습니다.

1. 브랜치 비교 확인하기 🔍

가장 먼저 할 일은 소스 브랜치와 대상 브랜치 사이에 실제로 어떤 차이가 있는지 확인하는 것입니다.

• 웹 UI 활용: GitHub, GitLab 등의 머지 리퀘스트 페이지에서 "Changes" 또는 "Files changed" 탭을 확인해 보세요. 변경된 파일 목록과 내용을 볼 수 있습니다. 만약 여기에 아무것도 뜨지 않는다면, 정말로 차이가 없다는 뜻일 가능성이 큽니다.
• 로컬에서 직접 비교: 터미널에서 다음 명령어를 사용해 직접 두 브랜치 간의 차이를 확인할 수 있습니다.

  git fetch origin
  git diff origin/main origin/my-feature
  

  (origin/main은 대상 브랜치, origin/my-feature는 여러분의 피처 브랜치입니다.

2. 커밋 히스토리 확인하기 📜

여러분의 커밋이 대상 브랜치에 이미 포함되어 있는지 확인해 보세요.

• git log --oneline --graph --all: 모든 브랜치와 커밋 히스토리를 시각적으로 볼 수 있습니다.
• git log origin/main..origin/my-feature: my-feature 브랜치에만 있는 커밋을 보여줍니다. 만약 아무것도 출력되지 않는다면, my-feature의 모든 커밋이 이미 main에 있다는 의미입니다.

3. 대상 브랜치 다시 확인하기 ✅

머지 리퀘스트를 생성할 때 선택한 대상 브랜치가 올바른지 다시 한번 꼼꼼히 확인해 보세요.

4. 로컬 브랜치 최신화 및 리베이스(Rebase) 고려하기 ⬆️

로컬 main 브랜치를 최신 상태로 업데이트한 후, 여러분의 피처 브랜치를 main에 리베이스(rebase) 하거나 머지(merge) 하여 충돌을 해결하고 다시 푸시하는 것을 고려해볼 수 있습니다.

git checkout my-feature             # 피처 브랜치로 이동
git pull origin main --rebase       # main 브랜치 변경사항을 rebase (충돌 시 해결 후 git rebase --continue)
git push -f origin my-feature       # 원격 브랜치에 강제 푸시 (주의! rebase는 히스토리를 변경하므로 신중해야 합니다.)

---

"머지할 내용이 없다"는 메시지는 대부분 이미 작업 내용이 반영되었거나, 브랜치 선택의 오류, 또는 revert와 같은 히스토리 변경에서 비롯됩니다. 위에서 제시된 방법들을 통해 차근차근 원인을 찾아 해결해나가시면 어렵지 않게 문제를 해결할 수 있을 겁니다. 

 

보너스

• git diff: 두 브랜치/커밋 간의 차이를 비교하는 명령어입니다.
  • https://git-scm.com/docs/git-diff
  • 이 명령어를 통해 소스 브랜치와 대상 브랜치 사이에 실제 변경 사항이 있는지 확인할 수 있습니다.
• git log: 커밋 히스토리를 확인하는 명령어입니다.
  • https://git-scm.com/docs/git-log
  • git log <branch1>..<branch2>와 같은 형태로 사용하여 branch2에만 있는 커밋을 찾아볼 수 있습니다.
• git merge: 브랜치를 합치는 명령어입니다.
  • https://git-scm.com/docs/git-merge
  • "이미 머지됨" 상황과 관련하여, Git이 어떻게 병합을 처리하는지 이해하는 데 도움이 됩니다.
• git rebase: 커밋 히스토리를 재구성하는 명령어입니다.
  • https://git-scm.com/docs/git-rebase
  • rebase 후 force push 등으로 인해 기존 커밋이 대상 브랜치에 이미 존재하게 되는 상황을 이해하는 데 중요합니다.
• git revert: 특정 커밋의 변경 사항을 되돌리는 새로운 커밋을 생성하는 명령어입니다.
  • https://git-scm.com/docs/git-revert
  • 이전에 revert된 내용이 다시 PR로 들어올 때 "머지할 내용이 없다"고 뜨는 경우를 이해하는 데 도움이 됩니다.