Vercel 에서 플랫폼 오류 페이지 커스터마이징 지원
요약
Vercel은 이제 플랫폼 수준의 오류(예: 함수 호출 시간 초과, 처리되지 않은 오류)에 대한 사용자 정의 오류 페이지를 지원합니다. 개발자는 Next.js와 같은 프레임워크의 관습을 사용하여 커스텀 오류 페이지를 구현할 수 있으며, Vercel이 이를 자동으로 감지하여 표시합니다. 이 기능은 요청별 컨텍스트(Request-specific context)를 포함하는 메타데이터 토큰을 제공하여 디버깅 및 사용자 경험 개선에 도움을 줍니다.
핵심 포인트
- Vercel 플랫폼 오류 페이지 커스터마이징 기능을 도입했습니다.
- 함수 호출 시간 초과나 처리되지 않은 오류 등 플랫폼 레벨의 오류를 브랜드화된 페이지로 대체할 수 있습니다.
- Next.js와 같은 프레임워크 표준(예: `public/500/page.tsx`)을 사용하여 커스텀 페이지를 구현합니다.
- 오류 페이지에 요청 ID (`::vercel:REQUEST_ID::`) 및 오류 코드 (`::vercel:ERROR_CODE::`) 등의 컨텍스트 토큰을 포함할 수 있습니다.
이제 Vercel 의 플랫폼 오류에 대한 오류 페이지를 커스터마이징할 수 있습니다. 일반적인 오류 페이지 대신 브랜드화된 사용자 경험을 제공하세요. Vercel 이 함수 호출 시간 초과(function invocation timeouts)나 기타 플랫폼 오류(platform errors)와 같이 처리하지 못한 오류(uncaught errors)를 발견할 때 커스텀 오류 페이지가 표시됩니다. 프레임워크의 관습을 사용하여 커스텀 오류 페이지를 구현할 수 있으며, Vercel 은 자동으로 해당 페이지를 찾아냅니다. 예를 들어 Next.js 의 경우 public 디렉토리에 500/page.tsx 또는 500.html 정적 페이지를 배치하면 됩니다.
오류 페이지에 요청별 컨텍스트(request-specific context)를 추가하려면 다음 메타데이터 토큰(metadata tokens)을 사용할 수 있습니다:
- 이 기능은 Enterprise 팀에서 사용 가능하며, 모든 프로젝트에 자동으로 활성화됩니다. 추가 구성이 필요하지 않습니다.
- 시작하기 위해 문서를 참조하거나 다음 구현 사례를 참고하세요: App Router 와 public 디렉토리를 사용한 커스텀 오류 페이지.
작동 방식:
- Vercel 요청 ID 를 포함합니다: ::vercel:REQUEST_ID::
- 특정 오류 코드를 포함합니다 (예): ::vercel:ERROR_CODE:: FUNCTION_INVOCATION_TIMEOUT
AI 자동 생성 콘텐츠
본 콘텐츠는 Vercel AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기