Next.JS Routing

라우팅 Convention

Next.js에서는 pages 디렉토리를 중심으로 한 라우팅 규칙을 따릅니다. 이 규칙에 따르면, pages 디렉토리 내에 있는 파일 및 폴더 구조가 URL 경로로 직접 반영됩니다. 예를 들어, pages/about.js는 웹 사이트의 /about 경로로 접근할 때 해당 페이지를 보여주며, pages/blog/[slug].js는 동적 라우팅을 지원하여 /blog/ 뒤에 오는 모든 경로를 해당 파일에서 처리할 수 있게 합니다. 이러한 구조는 웹사이트의 라우팅을 직관적으로 관리할 수 있게 해주며, 개발자가 웹사이트의 구조를 쉽게 이해할 수 있도록 돕습니다.

Interceptor Routing

Next.js의 인터셉터 라우팅 기능은 특정 경로에 대한 요청을 가로채 다른 경로의 컨텐츠를 보여주는 고급 기능입니다. 예를 들어, 사용자가 피드에서 사진을 클릭했을 때, 해당 사진의 상세 페이지로 이동하는 대신 현재 페이지의 컨텍스트를 유지하면서 모달 형태로 사진을 보여주고 싶은 경우에 유용합니다. 이를 통해 사용자 경험을 크게 개선할 수 있습니다.

모달을 위한 라우팅

인터셉터 라우팅은 모달이나 오버레이와 같은 UI 패턴을 구현할 때 특히 유용합니다. 사용자가 URL을 통해 모달 내용을 공유할 수 있게 하고, 페이지를 새로 고침하거나 뒤로 가기를 했을 때 모달이 자연스럽게 닫히는 등의 동작을 구현할 수 있습니다. 이는 사용자에게 더욱 직관적이고 편리한 웹 경험을 제공합니다.

미들웨어의 활용

Next.js의 미들웨어 기능은 요청이 라우트 핸들러에 도달하기 전에 특정 작업을 수행할 수 있게 해줍니다. 이를 통해 인증, 국가별 페이지 처리, 크로스 브라우징 처리 등 다양한 작업을 구현할 수 있습니다. 미들웨어는 특정 경로에 대해서만 적용되도록 설정할 수 있으며, matcher 옵션을 통해 이를 구성할 수 있습니다. 예를 들어, 특정 경로에 대한 접근을 제한하거나, 특정 조건을 만족하는 요청에 대해서만 특정 작업을

수행하도록 설정할 수 있습니다.

동적 매칭과 조건문

matcher를 사용하여 미들웨어가 적용될 경로를 정적으로 지정할 수 있지만, 동적인 조건에 따라 미들웨어의 동작을 제어하고 싶은 경우에는 미들웨어 내부에 조건문을 작성하여 이를 해결할 수 있습니다. 이를 통해 더욱 유연하고 세밀한 라우팅 및 요청 처리 로직을 구현할 수 있습니다.

미들웨어의 기본 개념

미들웨어는 서버와 클라이언트 사이에서 중간 처리 역할을 수행합니다. Next.js에서는 이를 통해 다음과 같은 작업을 수행할 수 있습니다:

• 사용자 인증 및 권한 검사
• 특정 국가 또는 언어에 따른 페이지 리다이렉션
• 브라우저 검사 및 크로스 브라우징 이슈 대응
• 봇이나 웹 크롤러 탐지 및 차단
• 사용자의 요청에 따른 페이지 리라이트(rewrite) 또는 리다이렉션(redirect)
• A/B 테스트를 위한 요청 분기 처리
• 요청과 응답 로깅

미들웨어 설정하기

미들웨어를 설정할 때는 matcher 속성을 사용하여 특정 경로에 대한 미들웨어 실행을 제한할 수 있습니다. 다음은 matcher를 사용하는 예제입니다:

export const config = {
  matcher: [
    '/((?!api|_next/static|_next/image|favicon.ico).*)',
  ],
};

위 설정은 API 경로, 정적 파일, 이미지, 파비콘이 아닌 모든 요청에 대해 미들웨어를 적용합니다. 동적인 값으로 matcher를 설정할 수 없으며, 빌드 타임에 정의된 경로에만 적용됩니다.

조건부 미들웨어 실행

경로가 같더라도 특정 조건에 따라 다르게 동작해야 할 때가 있습니다. 이런 경우 미들웨어 내부에서 조건문을 사용하여 처리할 수 있습니다. 예를 들어, /notice 경로에 접근하는 모든 요청을 /notice/1로 리라이트하고 싶다면 다음과 같이 작성할 수 있습니다:

import { NextRequest, NextResponse } from "next/server";

export function middleware(request: NextRequest) {
  if (request.nextUrl.pathname.startsWith("/notice")) {
    // /notice로 시작하는 모든 경로를 /notice/1로 리라이트
    return NextResponse.rewrite(new URL("/notice/1", request.url));
  }

  if (request.nextUrl.pathname.startsWith("/login")) {
    // 로그인 페이지 접속 시 메인 페이지로 리다이렉션
    return NextResponse.redirect(new URL("/", request.url));
  }
}

export const config = {
  matcher: ["/about/:path*", "/notice/:path*"],
};

이 예제에서는 /notice 경로에 접근하는 모든 요청을 /notice/1로 리라이트하여 사용자가 실제로는 /notice에 접근했지만, /notice/1의 컨텐츠를 볼 수 있도록 설정했습니다. 이런 방식은 특정 경로에 대한 접근을 제한하거나 기본값을 설정할 때 유용합니다.

결론

Next.js의 라우팅 시스템은 웹 애플리케이션 개발에서 중요한 부분을 담당합니다. 파일 기반 라우팅 규칙, 인터셉터 라우팅, 미들웨어 등의 기능을 통해 개발자는 사용자에게 뛰어난 웹 경험을 제공할 수 있습니다. 이러한 기능들은 Next.js를 사용하여 현대적이고 강력한 웹 애플리케이션을 구축하는 데 있어 핵심적인 역할을 합니다.

Next.js는 리액트 기반의 프레임워크로, 서버 사이드 렌더링(SSR), 정적 사이트 생성(Static Site Generation, SSG), API 라우트 등 다양한 기능을 제공합니다. 이 중 미들웨어는 Next.js 애플리케이션에서 요청이 라우트 핸들러에 도달하기 전에 실행되는 코드 조각을 의미합니다. 이 기능을 통해 인증, 리다이렉션, 로깅 등 다양한 작업을 수행할 수 있습니다.

Next.js의 미들웨어는 애플리케이 션의 요청 처리 과정에 커스텀 로직을 추가할 수 있는 강력한 기능을 제공합니다. matcher와 조건문을 활용하여 더 세밀하고 유연한 라우팅 및 요청 처리 전략을 구현할 수 있습니다. 이를 통해 사용자 경험을 향상시키고, 애플리케이션의 보안을 강화하며, 다양한 요구 사항을 효과적으로 충족시킬 수 있습니다.