AI가 만든 코드를 배포하기 전에 무엇을 확인해야 하나요?
AI가 작성한 코드를 배포하기 전에 존재하지 않는 API, 비밀값 노출, 입력 검증, 비동기 오류, 서버·브라우저 경계를 확인하는 시작 가이드입니다.
#배포
애플리케이션 빌드 이후 공개 환경에 반영하는 과정의 문서입니다.
문제 해결 가이드
6개 문서AWS Amplify에서 Next.js 배포가 완료되지 않아요
AWS Amplify의 Next.js 빌드가 성공한 뒤 required-server-files.json 누락 오류로 배포되지 않을 때 확인 문서로 이동합니다.
PHP 업그레이드 뒤 기존 사이트에 오류가 생겼어요
PHP 업그레이드 뒤 기존 사이트가 깨질 때 버전·오류 원문·파일·줄·실행 환경을 비교하는 가이드입니다.
Vercel 배포 로그에 오류가 표시돼요
Vercel 배포 과정에서 표시된 원문 오류 메시지를 기준으로, 이미 확인된 오류 문서로 이동하는 가이드입니다.
Vite 환경 변수가 undefined로 보여요
Vite에서 import.meta.env 값이 undefined이거나 비어 있을 때 변수 접두사·실행 mode·재빌드 여부를 확인합니다.
WordPress 업데이트 뒤에 오류가 생겼어요
WordPress 업데이트 뒤에 유지보수 화면, 자동 업데이트 실패, 파일 쓰기 권한 오류가 표시될 때 원문 메시지로 확인 문서를 고릅니다.
오류·증상
18개 문서401 {"message":"Unauthorized"}
Amazon Web Services 공식 원문에 표시된 401 {"message":"Unauthorized"} 항목의 문구를 확인하는 문서입니다.
배포된 클라이언트가 localhost API 주소를 호출함
AI가 생성한 fetch·axios 주소가 개발용 localhost로 고정되어 운영 브라우저에서 API를 호출하지 못하는지 확인합니다.
AI가 만든 클라이언트 번들에 서버 비밀값이 포함됨
API 키·토큰·데이터베이스 연결 문자열이 브라우저 번들·소스맵·네트워크 응답에 포함되었는지 확인합니다.
Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음
AWS Amplify 모노리포 배포에서 appRoot, AMPLIFY_MONOREPO_APP_ROOT, buildPath, baseDirectory가 실제 Next.js 앱 경로와 맞지 않는지 확인하는 문서입니다.
Cannot connect to the Docker daemon at unix:///var/run/docker.sock
Cannot connect to the Docker daemon at unix:///var/run/docker.sock 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.
Cannot load project settings
Vercel 공식 원문에 표시된 Cannot load project settings 항목의 문구를 확인하는 문서입니다.
Command not found in vercel dev
Vercel 공식 원문에 표시된 Command not found in vercel dev 항목의 문구를 확인하는 문서입니다.
Conflict. The container name "/app" is already in use by container
Conflict. The container name "/app" is already in use by container 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.
CustomerError: Can't find required-server-files.json in build output directory
Next.js 빌드는 성공했지만 AWS Amplify가 배포 산출물에서 서버 실행 메타데이터 파일을 찾지 못해 배포가 중단된 상태입니다.
error 500 del servidor
PHP Documentation Group 공식 원문에 표시된 error 500 del servidor 항목의 문구를 확인하는 문서입니다.
Failed to install builder dependencies
Vercel 공식 원문에 표시된 Failed to install builder dependencies 항목의 문구를 확인하는 문서입니다.
GitHub app installation not found
Vercel 공식 원문에 표시된 GitHub app installation not found 항목의 문구를 확인하는 문서입니다.
HTTP ERROR 500
SIR 공식 원문에 표시된 HTTP ERROR 500 항목의 문구를 확인하는 문서입니다.
import.meta.env.VITE_* is undefined
Vite 애플리케이션에서 import.meta.env의 환경 변수가 undefined로 보일 때 변수 이름·모드·빌드 시점을 확인합니다.
Invalid Edge Config connection string
Vercel 공식 원문에 표시된 Invalid Edge Config connection string 항목의 문구를 확인하는 문서입니다.
Invalid route destination segment
Vercel 공식 원문에 표시된 Invalid route destination segment 항목의 문구를 확인하는 문서입니다.
Invalid route source pattern
Vercel 공식 원문에 표시된 Invalid route source pattern 항목의 문구를 확인하는 문서입니다.
Invalid src prop: hostname is not configured under images in your next.config.js
Next.js `Image`의 외부 이미지 호스트가 `images.remotePatterns`에 정확히 등록되지 않았는지 확인합니다.