빠른 소식

Next.js canary, forbidden()·unauthorized() 안정화 철회…실험 설정 다시 필요

·설명 약 2분·작성: 해비·블로그 소개

이번 소식

Next.js가 forbidden()·unauthorized()의 안정화 변경을 되돌렸습니다. 두 함수는 권한 부족·미로그인 상황에 맞는 오류 화면을 표시하는 기능입니다. 철회 변경은 16.4.0-canary.63 프리릴리스에 포함됐으며, 기능은 다시 실험 단계로 유지됩니다.

달라진 점

  • 두 함수를 쓰려면 next.config.js 또는 next.config.ts에서 experimental.authInterrupts: true를 켜야 합니다. 플래그 없이 함수를 호출하면 실험 기능 설정이 필요하다는 오류가 발생하도록 코드가 복원됐습니다.
  • 공식 문서의 16.4.0 안정화 설명과 해당 설정의 폐기 안내도 제거됐습니다. 이번 배포는 정식 16.4 출시가 아닙니다.
  • 철회 이유는 기능을 쓰지 않는 앱에도 기본 401·403 오류 화면이 매 페이지의 전송 내용에 포함되는 문제입니다. 작성자는 새 create-next-app 프로젝트에서 페이지당 압축 전 약 2.3KB, gzip 후 약 125바이트가 늘었다고 설명했습니다. 모든 앱에서 같은 크기가 늘어난다는 측정은 아닙니다.

어떤 점이 달라지나요?

최근 안정화 변경을 보고 실험 설정을 지운 canary 사용자라면, canary.63에서 두 함수를 계속 쓰기 전에 설정을 다시 확인해야 합니다. 예를 들어 관리자 전용 화면이나 로그인 안내 화면에서 이 API를 호출하는 프로젝트가 대상입니다. 일반 정식 버전 전체의 장애나 보안 취약점이 발표된 것은 아닙니다.

Next.js 측은 필요한 시점에만 오류 화면을 렌더링하도록 구현을 고칠 때까지 실험 상태를 유지하겠다고 밝혔습니다. 안정화 재개일은 제시하지 않았으며, 이 글에서는 앱 실행·용량 측정을 직접 재현하지 않았습니다.

공식 출처·발표 시점

철회 병합: 2026년 10월 7일 01:38:02 KST. canary.63 공개: 같은 날 02:29:39 KST. 공식 PR의 변경 이유와 설정 문서를 함께 확인했습니다.

원문 출처 보기 →

이 소식이 도움이 되었나요?

댓글 0

이 글을 쓴 해비

웹사이트를 제작·운영하고, 개인 서비스와 자동화·AI 도구를 만듭니다. 직접 만들며 배운 내용과 문제 해결 과정을 BlogFlow에 기록합니다.

새 글 받아보기

RSS 리더에서 BlogFlow의 새 글을 확인할 수 있습니다.

RSS 피드 구독하기

댓글 남기기