Git Push의 공포... Azure DevOps와 LFS 413 에러

개발자라면 누구나 공감할 순간이 있습니다.
새벽까지 달려서 기능을 완성하고, 뿌듯한 마음으로 커밋 메시지를 작성한 뒤 'Push' 버튼을 눌렀을 때...
성공 메시지 대신 빨간색 에러 박스가 떴을 때의 그 서늘함... 😱

오늘은 최근 프로젝트를 진행하며 Azure DevOps와 GitKraken을 연동하다 마주친, 에러들과 그 해결 과정을 공유하려 합니다.

특히 대용량 파일(LFS)을 다루는 게임 개발자나 언리얼 엔진 사용자라면 이 글이 분명 도움이 될 거예요.

---

1. Authentication Error

평소처럼 Push를 눌렀는데, 터미널이 토해낸 로그는 다소 황당했습니다.

> `fatal: cannot determine the organization name for this 'dev.azure.com' remote URL.`

"아니, 방금 로그인했는데 조직 이름을 모른다니?"

Azure DevOps(구 VSTS)는 URL 구조가 조금 독특해서, 

Git이 종종 "도대체 어디까지가 조직 이름이고 어디서부터가 리포지토리 이름이야?"라며 혼란스러워할 때가 있습니다.

해결책: 길을 잃은 Git에게 지도 쥐어주기

이 문제는 Git 설정에서 HTTP 경로 사용을 명시적으로 허용해주면 해결됩니다.

Git에게 "URL 경로 전체를 보고 판단해!"라고 알려주는 것이죠.

git config --global credential.useHttpPath true

이 한 줄로 첫 번째 관문은 가볍게 통과했습니다.

---

2. HTTP 413 Error

인증 문제를 해결하고 다시 Push를 시도하자, 이번엔 업로드 게이지가 올라가다가 툭 끊겨버렸습니다.

 

> `LFS: Client error ... from HTTP 413`
> `pre-push Failed Git Hook exited with 2`

 

HTTP 413 (Payload Too Large)

서버가 "야, 이건 너무 크잖아! 못 받아!"라고 소리치는 에러입니다. 주로 언리얼엔진 프로젝트처럼 Git LFS를 사용하는 환경에서 용량이 큰 에셋을 올릴 때 발생합니다.

---

2.1 버퍼 늘리기 (절반의 성공)

보통은 Git의 전송 버퍼(`http.postBuffer`)를 늘리면 해결됩니다. 저도 500MB까지 늘려보았죠.

git config --global http.postBuffer 524288000

하지만 제 경우엔 이걸로도 해결되지 않았습니다. 여전히 413 에러가 저를 막아서더군요.

2.2 HTTP 버전 낮추기 (The Magic Fix)

최신 프로토콜인 HTTP/2는 빠르지만, Azure DevOps와 대용량 파일 전송 사이에서 가끔 불협화음(버그)을 일으킵니다.

이를 구버전인 HTTP/1.1로 강제하면 거짓말처럼 안정적으로 변합니다.

git config --global http.version HTTP/1.1

속도가 아주 미세하게 느려질 순 있지만, 전송 실패보다는 느린 성공이 낫습니다.

이 설정을 적용하자마자 해결되었습니다.

---

3. Branch Conflict

모든 에러를 잡고, Merge를 하려는 찰나... GitKraken이 또 하나의 창을 띄웁니다.

순간 "또 에러인가?" 싶어 긴장했지만, 자세히 보니 이건 에러가 아니었습니다.
서버(Remote)에 있는 `Dev` 브랜치를 가져오려고(Checkout) 했는데, 제 컴퓨터(Local)에 이미 똑같은 이름의 `Dev` 브랜치가 있어서 GitKraken이 멈칫한 것이었죠.

해결책: Reset Local to Here

이건 충돌이 아니라 '선택'의 문제입니다.

저는 서버의 최신 상태를 내 컴퓨터에 그대로 반영하고 싶었기 때문에 해결책은 간단했습니다.

* Action: 알림창에서 [Reset Local to Here] 클릭.
* Meaning: "내 로컬 `Dev` 브랜치를 방금 서버에서 가져온 저 지점으로 강제로 맞춰줘(동기화해줘)."

---

📝 마치며

오늘의 트러블슈팅을 요약하면 다음과 같습니다.

 

1.  조직 이름 에러: `credential.useHttpPath true`로 해결.
2.  LFS 413 에러: `http.version HTTP/1.1`로 안정성 확보 (가장 중요! ⭐)
3.  브랜치 이름 중복: 당황하지 말고 `Reset`으로 동기화.

 

에러 박스는 뜰 때마다 심장이 철렁하지만,

하나씩 해결하고 나면 시스템을 더 깊이 이해하게 되는 계기가 됩니다.

혹시 지금 Azure DevOps와 LFS 문제로 고통받고 계신다면 위 설정들을 꼭 한번 확인해보세요.