처음 만난 Next.js 문서


6.4

마치며

이번 장에서 배운 내용은 아래와 같습니다.

  • Middleware
    • 컴퓨터 시스템에서 응용 프로그램과 운영체제의 중간 계층에서 작동하는 프로그램
    • 서로 다른 소프트웨어 애플리케이션 간의 상호 작용을 쉽게 해줌으로써 통합을 편리하게 하는 역할
  • Next.js의 Middleware
    • 서버에서 요청에 대해 응답하기 전에 실행되는 코드 또는 프로그램
    • 요청이 완료되기 전에 코드를 실행할 수 있음
    • 사용 사례
      • 사용자의 로그인 여부나 권한을 확인해서 각 상황에 맞게 처리하고 싶은 경우
      • 서버 측에서 Redirection을 하고 싶은 경우
      • 요청에 포함된 Cookie의 값을 조작하거나, 응답에 포함시킬 Cookie를 넣고 싶은 경우
      • 요청 및 응답 헤더를 설정하고 싶은 경우
      • Response 또는 NextResponse 인스턴스를 직접 반환함으로써 곧바로 응답하고 싶은 경우
    • Middleware에서 크고 복잡한 데이터를 가져오거나 조작하는 동작을 수행하면 안 됨
    • 프로젝트의 최상위 경로에 middleware.ts파일을 작성하여 사용
      • 기본적으로 모든 route path에 대해 실행 됨
      • Matcher를 사용하면 특정 경로에서만 Middleware를 실행하거나, 일부 경로를 제외한 나머지 모든 경로에서 Middleware를 실행할 수 있음
    • Middleware 사용 예시
      • Cookie 조작
      • 요청 및 응답 Header 조작
      • Response 직접 반환

마지막 업데이트: 2025년 10월 24일 02시 21분

이 문서의 저작권은 이인제(소플)에 있습니다. 무단 전재와 무단 복제를 금합니다.

On this page

  • 6.4 마치며