문의·예약 신청 결과를 확인할 수 없어요
문의·예약 신청 뒤 완료 화면, HTTP 요청, 관리자 기록, 운영자 알림을 단계별로 비교하는 가이드입니다.
프론트엔드
브라우저 렌더링, 사용자 화면, 프론트엔드 빌드와 실행 오류에 관한 문서입니다.
문제 해결 가이드
7개 문서AI가 만든 웹 코드가 이상하게 동작해요
AI가 작성한 코드를 붙인 뒤 화면·API·배포가 예상과 다르게 동작할 때 자주 반복되는 구현 실수를 분류하는 시작 가이드입니다.
AWS Amplify에서 Next.js 배포가 완료되지 않아요
AWS Amplify의 Next.js 빌드가 성공한 뒤 required-server-files.json 누락 오류로 배포되지 않을 때 확인 문서로 이동합니다.
HTTP 개발 주소에서 브라우저 기능이 실행되지 않아요
HTTP 개발 주소에서 Service Worker·위치·카메라 같은 브라우저 기능이 실행되지 않을 때 보안 컨텍스트 오류와 Mixed Content 차단을 구분하는 가이드입니다.
React 화면이 처음 로드될 때 hydration 오류가 나요
React 서버 렌더링 화면의 첫 HTML과 브라우저 렌더링이 다를 때 발생한 문구와 재현 조건을 기록합니다.
Vercel 배포 로그에 오류가 표시돼요
Vercel 배포 과정에서 표시된 원문 오류 메시지를 기준으로, 이미 확인된 오류 문서로 이동하는 가이드입니다.
Vite 환경 변수가 undefined로 보여요
Vite에서 import.meta.env 값이 undefined이거나 비어 있을 때 변수 접두사·실행 mode·재빌드 여부를 확인합니다.
오류·증상
17개 문서폼 브라우저 기본 검증이 요청 전송을 막음
필수 입력이나 입력 형식 검증 때문에 폼 요청 자체가 서버로 전송되지 않는지 확인합니다.
폼 제출 뒤 완료 결과를 확인할 수 없음
문의 또는 예약 폼을 제출한 뒤 완료 화면, 관리자 기록, 운영자 알림 중 어떤 결과도 확인하지 못할 때 관찰 범위를 구분하는 문서입니다.
폼 제출 뒤 완료 화면으로 리디렉션되지 않음
폼 POST는 처리됐지만 완료 화면으로 이동하지 않아 사용자가 결과를 확인하지 못하는지 점검합니다.
폼의 action 또는 method가 처리 주소와 맞지 않음
문의·예약 폼을 제출했지만 요청이 예상한 처리 주소나 HTTP 메서드로 전송되지 않는지 확인하는 문서입니다.
AI가 만든 낙관적 UI가 저장 실패 후에도 성공 상태로 남음
서버 저장 전에 화면을 성공 상태로 바꾼 뒤 요청이 실패해도 원래 값과 오류 상태로 되돌리지 않는지 확인합니다.
AI가 만든 화면이 API 대기 중 빈 화면으로 남음
데이터 요청 중·성공·실패 상태를 구분하지 않아 사용자가 빈 화면을 오류로 오해하는지 확인합니다.
AI가 만든 UI를 키보드만으로 조작할 수 없음
클릭 가능한 요소가 키보드 포커스를 받지 못하거나 Enter·Space 동작을 제공하지 않는지 확인합니다.
Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음
AWS Amplify 모노리포 배포에서 appRoot, AMPLIFY_MONOREPO_APP_ROOT, buildPath, baseDirectory가 실제 Next.js 앱 경로와 맞지 않는지 확인하는 문서입니다.
AuthSessionMissingError: Auth session missing!
Supabase 공식 원문에 표시된 AuthSessionMissingError: Auth session missing! 항목의 문구를 확인하는 문서입니다.
Cannot load project settings
Vercel 공식 원문에 표시된 Cannot load project settings 항목의 문구를 확인하는 문서입니다.
Client Component를 async 함수로 선언함
use client가 있는 React·Next.js 컴포넌트를 async 함수로 만들어 Promise를 반환하는지 확인합니다.
Command not found in vercel dev
Vercel 공식 원문에 표시된 Command not found in vercel dev 항목의 문구를 확인하는 문서입니다.
Cross-Origin Request Blocked
Amazon Web Services 공식 원문에 표시된 Cross-Origin Request Blocked 항목의 문구를 확인하는 문서입니다.
CustomerError: Can't find required-server-files.json in build output directory
Next.js 빌드는 성공했지만 AWS Amplify가 배포 산출물에서 서버 실행 메타데이터 파일을 찾지 못해 배포가 중단된 상태입니다.
Dynamic server usage: Route used cookies() or headers()
Dynamic server usage: Route used cookies() or headers() 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.
ERR_NETWORK
axios 유지보수자 저장소 공식 원문에 표시된 ERR_NETWORK 항목의 문구를 확인하는 문서입니다.
Failed to find Server Action
현재 빌드에서 요청된 Server Action을 찾지 못했다는 Next.js 오류 메시지입니다.