Vercel에 배포했는데 예전 화면이 보일 때, Git 브랜치부터 확인하는 순서

GitHub에 push했고 Vercel에서도 Ready를 봤는데, 휴대폰이나 공개 도메인에는 어제 화면이 남아 있으면 다시 코드를 고치고 싶어집니다. 하지만 이 경우 첫 질문은 “컴포넌트가 틀렸나?”가 아닙니다. **내가 바꾼 commit이 지금 공개 도메인까지 갔나?**를 먼저 확인해야 합니다.

Vercel은 Git 연결 프로젝트에서 commit이나 pull request를 배포로 만들고, Local·Preview·Production 환경을 구분합니다. 또 프로젝트 개요에서 최신 production 배포의 commit과 로그를 볼 수 있습니다. Vercel의 배포 개요 문서를 열어 둔 채로 아래 순서만 따라가면, AI에게 “화면이 안 바뀌어요”라고 넓게 요청하는 일을 줄일 수 있습니다.

Tap to zoom

먼저 Preview URL과 공개 도메인을 같은 것으로 보지 마세요

Vercel의 Preview는 테스트·검토용이고, Production은 사용자에게 공개되는 production domain을 위한 환경입니다. 그래서 새 Preview URL에서만 바뀐 화면을 보고도 my-site.com은 그대로일 수 있습니다. 반대로 배포 목록의 한 항목이 Ready여도 그것이 현재 공개 도메인에 연결된 항목이라는 뜻은 아닙니다.

지금 브라우저 탭 두 개를 엽니다.

1. Vercel Deployments에서 방금 만든 deployment URL
2. 사용자가 실제로 들어가는 공개 도메인

두 탭에서 같은 문구나 같은 작은 변경을 찾습니다. 다르면 코드부터 다시 고치지 말고 다음 단계로 갑니다. 새 화면이 보이는 URL과 공개 도메인이 같은 배포를 가리키는지가 오늘의 첫 판별입니다.

Git branch와 commit SHA를 하나로 적어 둡니다

“main에 push했다”고 기억하는 것과 실제 production branch가 같은 것은 별개입니다. 터미널에서 현재 변경을 확인하고, 원격에 올라간 commit을 하나 적습니다.

git status
git branch --show-current
git log -1 --oneline
git push

여기서 필요한 것은 긴 로그가 아니라 네 가지입니다.

Vercel은 보통 production branch에 merge하거나 commit하면 Production으로 올릴 수 있지만, 프로젝트 설정과 팀의 배포 흐름에 따라 branch가 다를 수 있습니다. Vercel의 Production promotion 문서도 preview 배포를 의도적으로 Production으로 승격할 수 있다고 설명합니다. 따라서 “main일 것”이라고 가정하지 말고 프로젝트에서 실제 production branch와 deployment commit을 맞춰 보세요.

Git push 자체가 거절되거나 어떤 branch에 있는지 헷갈린다면, 먼저 push가 거절될 때 확인할 순서와 AI 수정 전 변경 범위를 묶는 프롬프트로 범위를 줄인 뒤 돌아오는 편이 안전합니다.

Vercel Deployment 상세에서 commit과 로그를 확인합니다

Deployments 목록에서 가장 최근 항목만 보고 끝내지 마세요. 방금 적어 둔 SHA와 같은 commit인지 확인하고, 그 deployment를 열어 build 로그와 배포 환경을 봅니다. Vercel 공식 문서에 따르면 대시보드에서는 최신 production 배포의 생성 URL, commit 상세, 로그를 확인할 수 있고, 특정 commit이나 branch를 수동 배포할 수도 있습니다.

이 단계에서 갈림길은 간단합니다.

• SHA가 다르다: 다른 branch, push 누락, 또는 다른 commit이 배포된 것입니다. 코드를 고치지 말고 Git 흐름부터 바로잡습니다.
• SHA는 같은데 Preview만 새롭다: 현재 공개 도메인에 연결된 production deployment를 다음 단계에서 확인합니다.
• SHA가 같고 build가 실패한다: 화면 문제로 보아도 build 로그의 첫 오류를 먼저 해결합니다. Vercel build 실패 로그를 읽는 방법처럼 실패한 command 한 줄과 첫 오류를 분리하면 AI 요청도 작아집니다.

commit SHA가 다르면 캐시를 지우거나 재배포 버튼을 누르기 전에 Git branch를 해결합니다. 이 순서가 재배포를 반복하며 다른 문제를 만드는 일을 막습니다.

공개 도메인이 어느 배포를 받고 있는지 확인합니다

SHA가 맞고 deployment도 Ready라면, 이제 공개 도메인 차례입니다. Vercel은 preview deployment를 Production으로 promote할 수 있고, production deployment의 domain assignment를 관리할 수 있습니다. 즉 “새 배포가 하나 있다”와 “그 배포가 지금 공개 도메인을 받고 있다”는 다른 확인값입니다.

Vercel의 해당 deployment 상세와 프로젝트의 Domains/Deployments 화면에서 다음을 확인합니다.

1. 현재 production domain이 어느 deployment와 연결됐는지
2. 그 deployment의 commit SHA가 방금 push한 SHA와 같은지
3. preview를 production으로 promote하는 팀 흐름을 쓰는지

여기서 예전 commit이 domain에 연결됐다면, 원인을 “캐시”라고 부르지 않아도 됩니다. 새 commit을 production branch에 반영할지, 검토한 preview를 production으로 promote할지, 팀의 배포 규칙에 맞는 한 가지 행동만 고르면 됩니다. 여러 재배포를 동시에 시작하지 않는 것이 중요합니다.

Tap to zoom

마지막에만 깨끗한 브라우저와 캐시를 봅니다

commit, deployment, domain 연결이 모두 같은데도 화면이 다르면 시크릿 창 또는 다른 브라우저로 같은 공개 도메인을 엽니다. 이때도 페이지에 표시한 작은 변경 한 개로 비교합니다. 로그인 상태, 브라우저 확장 프로그램, 로컬 저장값, 서비스 워커 또는 데이터 캐시처럼 환경별 원인이 남을 수 있기 때문입니다.

Vercel CLI에는 CDN·Data cache 관리 명령이 있지만, 공식 문서가 제공하는 관리 기능이라는 사실과 내 프로젝트에서 캐시를 지워야 한다는 판단은 다릅니다. 배포 대상이 틀린 상태에서 캐시를 비우면 원인 증거만 사라질 수 있습니다. 현재 프로젝트의 프레임워크 캐시 설정과 배포 방식은 팀 문서에서 확인한 뒤에만 다음 조치를 정하세요.

AI에게는 네 줄의 증거만 보내세요

AI에게 코드 전체를 다시 쓰라고 하기 전에, 아래처럼 문제를 좁혀 보세요.

Vercel 공개 화면이 예전 버전입니다.
branch: main
commit: a1b2c3d
deployment: Ready, commit은 a1b2c3d / public domain은 예전 화면

코드 전체를 바꾸지 말고, 다음에 확인할 Vercel 설정 또는 배포 대상을 한 단계만 알려주세요.

이 프롬프트는 해결을 보장하지 않습니다. 대신 Git·deployment·domain·browser 중 어느 단계에서 증거가 끊겼는지를 먼저 말하게 만듭니다. 그 뒤에만 필요한 로그나 설정 화면을 추가하면 됩니다.

오늘의 배포 확인 순서

• 현재 branch와 commit SHA를 적었다.
• Vercel deployment가 그 SHA를 빌드했는지 봤다.
• 공개 domain이 같은 production deployment를 받는지 확인했다.
• 시크릿 창에서 같은 작은 변경을 다시 봤다.
• 그 뒤에도 다르면, 증거 네 줄과 함께 최소 다음 조치를 AI에게 요청했다.

새 화면이 안 보인다고 코드부터 다시 고치지 마세요. 먼저 공개 도메인이 어느 commit의 deployment를 받고 있는지 확인하면, 다음 행동이 재배포인지 branch 수정인지 캐시 점검인지 분명해집니다.

참고 출처

• Vercel Docs: Deploying to Vercel
• Vercel Docs: Promoting Deployments
• Vercel Docs: CLI overview

이 글은 AI 코딩과 개발 학습의 일반 정보 제공 목적입니다. 도구, 모델, 커리큘럼, 요금은 버전과 시점에 따라 달라질 수 있으므로 실습이나 도입 전 공식 문서와 최신 릴리스 노트를 확인하세요.