[23기 런칭 스프린트 3주차] 배포 플랫폼부터 잘못 짚었던 이야기 (feat. GA4·SEO·커스텀 도메인)
2026.08.05
시도하고자 했던 것과 그 이유
토요일 모각 스터디에 참여해, 병원 경영진 대상 성과진단 웹서비스(MedDiag AI) MVP의 출시 직전 마무리 작업(GA4 추적, 공유 버튼, SEO/GEO, 커스텀 도메인)을 진행했다.
작업 중 예상 못한 반전이 있었다. 계속 "Vercel에 배포 중"이라는 전제로 문제를 진단하고 있었는데, 실제로는 Cloudflare Pages에 배포되고 있었다. 전제 하나가 틀렸다는 걸 알아챈 순간, 그동안의 진단(커밋 작성자 문제 등)이 전부 무효가 됐다.
진행 방법
어떤 도구를 사용했고, 어떻게 활용하셨나요?
Claude Code (Sonnet 5) + Next.js/TypeScript/Tailwind + Cloudflare Pages + Google Analytics 4 + AddToAny를 사용했다.
루프: 기능 구현 → 로컬 빌드 검증 → 배포 로그로 원인 확인 → 수정 → 커밋/푸시 → 실 도메인에서 직접 확인
겪었던 핵심 이슈 세 가지:
플랫폼 착각 — Vercel 기준으로 원인을 찾고 있었는데, 실제는 Cloudflare였다.
빌드 실패 원인 — Cloudflare 설정은 빌드 출력 폴더를 out으로 지정해뒀는데, 코드에는 정적 export 설정(output: 'export')이 빠져 있어 그 폴더가 아예 안 만들어지고 있었다.
도메인 오타 — empathy.com으로 연결하려다 낯선 기존 DNS 레코드를 발견, 확인해보니 실제 산 도메인은 empathyall.com이었다.
결과적으로 GA4 추적, 공유 버튼, SEO 메타데이터(title/OG/robots/sitemap), 구조화 FAQ(GEO), 커스텀 도메인(empathyall.com)까지 모두 붙여 배포했다.
결과와 배운 점
배운 점과 나만의 꿀팁을 알려주세요.
원인 후보를 나열하기 전에 "지금 어느 플랫폼 얘기인지"부터 확정해야 한다.
대시보드 상태 아이콘보다 실제 빌드 로그를 봐야 진짜 원인이 보인다.
"다시 시도" 버튼이 최신 커밋이 아니라 실패했던 배포를 그대로 재시도한다는 걸 처음 알았다.
되돌리기 번거로운 작업(도메인 등)일수록, 실행 전 낯선 정보가 보이면 그냥 넘기지 않는 게 중요하다.
과정 중에 어떤 시행착오를 겪었나요?
Vercel이라고 믿고 커밋 작성자 문제부터 의심하며 한참 엉뚱한 방향으로 진단했다.
Cloudflare 설정(out 폴더 지정)과 코드(정적 export 미설정)가 서로 어긋나 있어, 빌드는 성공해도 배포는 계속 실패했다.
empathy.com에 남아있던 기존 DNS 레코드(MX 11개, TXT 28개)를 이상하게 여기지 않았다면, 소유하지 않은 도메인을 잘못 연결할 뻔했다.
도움이 필요한 부분이 있나요?
기능 완성 시 빌드 검증부터 커밋·푸시까지 자동으로 이어지도록 워크플로우 규칙을 정해뒀는데, 실제로 여러 기능에 걸쳐 안정적으로 잘 지켜지는지는 더 지켜봐야 할 것 같다.
앞으로의 계획이 있다면 들려주세요.
GA4 실시간 리포트에서 실제 방문 데이터 확인
기능 완성 시 빌드 통과를 전제로 자동 커밋·푸시되도록 CLAUDE.md에 명문화해둔 워크플로우가 잘 작동하는지 검증
도움 받은 글 (옵션)
참고한 지피터스 글이나 외부 사례를 알려주세요.
토요일 모각 스터디장 박무재님의 전 과정에 걸친 세심한 지원과 피드백 덕분에 막히는 지점마다 바로 짚고 넘어갈 수 있었다.


