요즘IT가 스택오버플로 공개 데이터로 집계한 결과, 2026년 10월 한 달 동안 올라온 새 질문은 1,001개였습니다. 2022년 10월에는 105,743개였습니다. 같은 글은 스택오버플로 2026 개발자 설문에서 응답자 93%가 AI 답을 믿으려면 출처 표시가 필요하다고 답했다고 전합니다. 막히면 묻고 답을 찾던 곳이 줄었고, 그 자리를 AI 답이 채우고 있습니다.
Lovable, Bolt, v0, Cursor로 만든 서비스는 미리보기 화면에서 대부분 잘 동작합니다. 문제는 실제 주소에 올린 다음 날 나옵니다. 인수한 서비스에서 가장 먼저 확인하는 세 곳은 환경변수, 도메인 연결 뒤 로그인, 결제 키입니다. 셋 다 코드보다 설정에 있고, AI 도구가 대신 클릭해 줄 수 없는 계정 화면에 있습니다.
미리보기에서는 되는데 배포하면 왜 값이 비어 있습니까?
환경변수는 코드 밖에 두는 설정값입니다. DB 주소, API 키, 결제 키를 코드에 직접 쓰지 않고 이 이름표에 담아 둡니다. 개발 도구 안에서는 도구가 값을 채워 주지만, Vercel이나 Netlify에 올리면 그 값을 호스팅 쪽에 다시 넣어야 합니다.
Vercel 공식 문서는 두 가지를 분명히 기록해 두었습니다. 환경변수를 바꿔도 이미 나간 배포에는 적용되지 않고 새 배포에만 적용됩니다. 값마다 Production, Preview, Development 중 어느 환경에 쓸지 고르게 되어 있어, Preview에만 넣은 값은 실제 주소에서 비어 있습니다. 대시보드에서 값을 수정했는데 화면이 그대로라면 다시 배포하지 않은 경우가 대부분입니다.
브라우저에서 읽는 값은 규칙이 하나 더 있습니다. Next.js는 이름이 NEXT_PUBLIC_으로 시작하는 값을 빌드할 때 자바스크립트 파일 안에 그대로 박아 넣습니다. 빌드가 끝난 뒤에는 환경변수를 바꿔도 반영되지 않습니다. Vite 기반 도구(Lovable, Bolt 등)는 VITE_로 시작하는 값이 같은 방식으로 들어가며, Vite 문서는 이 값에 API 키 같은 민감한 정보를 넣지 말라고 경고합니다. 공개 접두사가 붙은 값은 누구나 브라우저 개발자 도구로 읽을 수 있다는 뜻입니다.
배포 직후 Vercel CLI로 실제 운영 환경에 어떤 값이 들어가 있는지 이름만 확인할 수 있습니다.
vercel env ls production
vercel env ls preview두 목록의 이름이 다르면 미리보기와 실제 주소의 동작이 달라집니다.
도메인을 연결했더니 로그인이 왜 깨집니까?
- 가입 확인 메일 링크가 localhost로 감
- 원인
- Site URL이 기본값
- 확인할 곳
- Supabase Authentication의 URL 설정
- 소셜 로그인 뒤 오류 화면
- 원인
- 운영 주소가 Redirect URLs에 없음
- 확인할 곳
- 같은 화면의 Redirect URLs
- www 주소와 www 없는 주소 중 한쪽만 로그인됨
- 원인
- 두 주소 중 하나만 등록
- 확인할 곳
- Redirect URLs, 도메인 연결 설정
- 배포 후 기능 하나가 undefined 오류
- 원인
- 운영 환경에 변수 없음
- 확인할 곳
- 호스팅 환경변수의 Production 항목
| 증상 | 원인 | 확인할 곳 |
|---|---|---|
| 가입 확인 메일 링크가 localhost로 감 | Site URL이 기본값 | Supabase Authentication의 URL 설정 |
| 소셜 로그인 뒤 오류 화면 | 운영 주소가 Redirect URLs에 없음 | 같은 화면의 Redirect URLs |
| www 주소와 www 없는 주소 중 한쪽만 로그인됨 | 두 주소 중 하나만 등록 | Redirect URLs, 도메인 연결 설정 |
| 배포 후 기능 하나가 undefined 오류 | 운영 환경에 변수 없음 | 호스팅 환경변수의 Production 항목 |
AI 도구로 만든 서비스는 로그인을 Supabase Auth에 위임하는 경우가 많습니다. Supabase에는 Site URL과 Redirect URLs라는 설정이 있습니다. Site URL은 코드에 돌아갈 주소를 지정하지 않았을 때 쓰는 기본 주소이고, 회원가입 확인 메일과 비밀번호 재설정 메일의 링크가 이 주소로 갑니다.
Supabase 문서의 예시 기본값은 http://localhost:3000입니다. 문서는 이 값을 실제 운영 주소로 바꾸라고 안내합니다. 바꾸지 않으면 가입 확인 메일을 클릭한 이용자가 자기 컴퓨터 주소로 이동해 빈 화면을 봅니다. 구글이나 카카오 로그인 뒤 돌아갈 주소도 Redirect URLs 목록에 있어야 합니다.
와일드카드(여러 주소를 한 번에 허용하는 * 표기)도 주의합니다. Supabase 문서는 **가 여러 경로를 한꺼번에 허용하므로 개발과 미리보기 주소에는 쓸 만하지만, 운영에는 정확한 주소를 적으라고 권합니다.
결제는 테스트에서 됐는데 실제 카드는 왜 안 됩니까?
국내 결제는 토스페이먼츠나 포트원 같은 결제대행사(PG)를 붙입니다. 토스페이먼츠 문서 기준으로 테스트 키는 test로, 라이브 키는 live로 시작합니다. 클라이언트 키 중간에는 ck 또는 gck, 시크릿 키 중간에는 sk 또는 gsk가 들어갑니다.
AI 도구는 문서에 공개된 테스트 키로 결제 화면을 만들어 줍니다. 테스트 결제는 실제 돈이 오가지 않으므로 출시 다음 날 첫 주문이 들어와도 매출이 생기지 않습니다. 주문서형과 결제창형 연동 키는 전자결제 신청을 마친 뒤에만 라이브 키를 확인할 수 있습니다. 사업자 명의로 신청하고 심사를 받는 일이라 사람이 직접 해야 합니다.
시크릿 키는 서버에만 둡니다. 토스페이먼츠는 시크릿 키를 SDK(브라우저용 결제 코드)에 넣으면 INSECURE_KEY_USAGE 오류를 내고 결제를 막습니다. 노출이 의심되면 API 키 화면에서 재발급하며, 재발급하면 기존 키는 7일 동안 함께 유효하고 유출이 확인되면 바로 폐기할 수 있습니다.
국내 서비스에서는 무엇이 다릅니까?
국내 서비스는 출시 전에 확인할 계정이 더 많습니다. 결제대행사 라이브 키는 전자결제 계약 이후에 나오고, 카카오 로그인은 카카오 개발자 사이트에 운영 주소를 따로 등록합니다. 도메인을 가비아나 카페24 같은 국내 등록업체에서 샀다면 DNS 설정 화면도 호스팅과 별도로 있습니다.
이 계정들은 대표자 명의, 사업자 명의로 만들어야 하고 본인 인증을 거칩니다. AI 도구가 코드를 만들어도 이 화면은 대신 클릭해 주지 못합니다. 인수하는 쪽에서 계정 목록부터 받는 이유입니다.
출시 전날 무엇을 확인합니까?
호스팅 환경변수의 Production 항목과 Preview 항목 이름이 같은지 확인합니다.
환경변수를 바꾼 뒤 다시 배포했는지 배포 시각으로 확인합니다.
NEXT_PUBLIC_, VITE_로 시작하는 값에 시크릿 키가 없는지 확인합니다.
Supabase Site URL이 운영 주소인지, Redirect URLs에 www 주소까지 있는지 확인합니다.
결제 키가 live로 시작하는지, 시크릿 키가 서버 코드에만 있는지 확인합니다.
실제 카드로 소액 결제와 취소를 한 번씩 해 봅니다.
빌드된 파일에 테스트 키가 남아 있는지는 이렇게 찾습니다.
grep -rE "test_(ck|gck|sk|gsk)_" dist/ .next/static/ 2>/dev/null결과가 나오면 결제 화면이 아직 테스트 키를 쓰고 있다는 뜻입니다.
참고: 요즘IT, 개발자들이 더 이상 질문하지 않는다면 (https://yozm.wishket.com/magazine/detail/4029/) / Vercel 문서, Environment variables (https://vercel.com/docs/environment-variables) / Next.js 문서, Environment Variables (https://nextjs.org/docs/app/guides/environment-variables) / Vite 문서, Env Variables and Modes (https://vite.dev/guide/env-and-mode) / Supabase 문서, Redirect URLs (https://supabase.com/docs/guides/auth/redirect-urls) / 토스페이먼츠 문서, API 키 (https://docs.tosspayments.com/reference/using-api/api-keys)