Vercel, 플랫폼 에러 페이지 커스터마이징 지원
·2026.01.23 22:00
Vercel이 브랜드 경험을 강화할 수 있도록 플랫폼 에러 페이지 커스터마이징 기능을 지원한다.
Vercel에서 함수 호출 타임아웃과 같은 플랫폼 에러(platform errors) 발생 시 표시되는 기본 에러 페이지를 브랜드 디자인에 맞춰 커스텀할 수 있다.
Next.js와 같은 프레임워크의 컨벤션을 그대로 활용할 수 있으며, 예를 들어 500/page.tsx를 생성하거나 public 디렉토리에 500.html 파일을 배치하면 Vercel이 이를 자동으로 인식한다.
에러 페이지에 요청 관련 컨텍스트를 추가하기 위해 다음 메타데이터 토큰을 사용할 수 있다:
::vercel:REQUEST_ID::: Vercel 요청 ID::vercel:ERROR_CODE::: 구체적인 에러 코드 (예:FUNCTION_INVOCATION_TIMEOUT)
디버깅과 기술 지원을 원활하게 하기 위해 요청 ID와 에러 코드를 에러 페이지에 포함할 것을 강력히 권장한다.
이 기능은 Enterprise 팀을 대상으로 하며, 별도의 설정 없이 모든 프로젝트에 자동으로 적용된다.
이 요약은 원문 이해를 돕기 위한 큐레이션입니다. 저작권은 원저작자에게 있으며, 정확한 내용과 맥락은 원문을 확인하세요.
요약 오류, 출처 표기 문제, 삭제 요청은 문의 · 건의로 알려주세요.