re:re:actable
Урок 115 минут чтения

Pages Router: что нужно знать для собеседования

На этой странице
Кратко

Pages Router — исходная модель Next.js (папка pages/), которая до сих пор поддерживается и встречается во множестве рабочих проектов. Каждый файл в pages/ — маршрут, все компоненты клиентские (гидратируются целиком). Данные загружаются функциями страницы, которые выполняются на сервере: getStaticProps (при сборке → SSG, с revalidate → ISR), getStaticPaths (какие динамические пути сгенерировать, fallback), getServerSideProps (на каждый запрос → SSR). Общая обёртка — _app.tsx (layout, провайдеры, глобальные стили), HTML-каркас — _document.tsx, API — pages/api/*, навигация — next/router (useRouter), метаданные — next/head. App Router отличается Server Components, вложенными layout, стримингом, Server Actions и новой моделью кэша. На собеседовании ждут, что ты сможешь сравнить модели и объяснить, как мигрировать постепенно — оба роутера могут работать в одном проекте.

Вопрос

Как устроен Pages Router? Чем getStaticProps, getStaticPaths и getServerSideProps отличаются друг от друга и от App Router?

Структура

pages/
├── _app.tsx            ← обёртка всех страниц
├── _document.tsx       ← <html>, <head>, <body> (только на сервере)
├── index.tsx           ← /
├── 404.tsx             ← своя страница 404
├── books/
│   ├── index.tsx       ← /books
│   └── [slug].tsx      ← /books/:slug
└── api/
    └── books.ts        ← /api/books (API Route)

getStaticProps + getStaticPaths: SSG и ISR

// pages/books/[slug].tsx
import type { GetStaticPaths, GetStaticProps, InferGetStaticPropsType } from 'next';
import Head from 'next/head';
 
export const getStaticPaths: GetStaticPaths = async () => {
  const popular = await getPopularBooks(100);
  return {
    paths: popular.map((b) => ({ params: { slug: b.slug } })),
    fallback: 'blocking', // остальные — на первом запросе, без промежуточного состояния
  };
};
 
export const getStaticProps: GetStaticProps<{ book: Book }> = async ({ params }) => {
  const book = await getBook(String(params?.slug));
  if (!book) return { notFound: true };                 // 404
  return { props: { book }, revalidate: 300 };          // ISR: обновлять раз в 5 минут
};
 
export default function BookPage({ book }: InferGetStaticPropsType<typeof getStaticProps>) {
  return (
    <>
      <Head><title>{book.title}</title></Head>
      <h1>{book.title}</h1>
    </>
  );
}
fallbackПоведение для путей, которых нет в paths
false404
trueСразу отдаётся страница в состоянии загрузки (router.isFallback), затем данные
'blocking'Сервер ждёт генерации и отдаёт готовый HTML (как SSR в первый раз)

getServerSideProps: SSR на каждый запрос

import type { GetServerSideProps } from 'next';
 
export const getServerSideProps: GetServerSideProps = async ({ req, res, query }) => {
  const session = await getSession(req);
  if (!session) {
    return { redirect: { destination: '/login', permanent: false } };
  }
  res.setHeader('Cache-Control', 'private, no-store');
  const orders = await getOrders(session.userId, Number(query.page ?? 1));
  return { props: { orders } };
};

Можно вернуть props, redirect или notFound. Доступны req, res, cookies — это аналог динамического рендера в App Router.

_app и _document

// pages/_app.tsx — состояние между страницами, провайдеры, глобальные стили
import type { AppProps } from 'next/app';
import '../styles/globals.css';
 
export default function App({ Component, pageProps }: AppProps) {
  return (
    <QueryClientProvider client={queryClient}>
      <Layout>
        <Component {...pageProps} />
      </Layout>
    </QueryClientProvider>
  );
}
// pages/_document.tsx — только серверный каркас, без логики и обработчиков
import { Html, Head, Main, NextScript } from 'next/document';
 
export default function Document() {
  return (
    <Html lang="ru">
      <Head />
      <body>
        <Main />
        <NextScript />
      </body>
    </Html>
  );
}

API Routes

// pages/api/books.ts
import type { NextApiRequest, NextApiResponse } from 'next';
 
export default async function handler(req: NextApiRequest, res: NextApiResponse) {
  if (req.method !== 'GET') return res.status(405).end();
  res.status(200).json(await listBooks());
}

Сравнение с App Router

Pages RouterApp Router
КомпонентыВсе клиентскиеСерверные по умолчанию
ДанныеgetStaticProps / getServerSideProps на уровне страницыawait в любом серверном компоненте
LayoutОдин _app (+ ручные паттерны)Вложенные layout.tsx, сохраняют состояние
Загрузка/ошибкиВручнуюloading.tsx, error.tsx, Suspense
СтримингНетДа
МутацииAPI Routes + клиентский fetchServer Actions
Метаданныеnext/headMetadata API
Навигацияnext/routernext/navigation
КэшISR через revalidateuse cache, теги, Router Cache

Миграция

  • app/ и pages/ могут жить вместе — переносят маршрут за маршрутом.
  • Один и тот же путь не может быть определён в обеих папках.
  • getStaticProps → async серверный компонент с кэшированием; getServerSideProps → динамический рендер; getStaticPaths → generateStaticParams; _app/_document → корневой layout.tsx; API Routes → Route Handlers (app/api/.../route.ts).
  • Переходы между маршрутами разных роутеров — полная перезагрузка страницы.

Что важно помнить

  • Pages Router не устарел официально и поддерживается, но новые возможности (RSC, Cache Components, Server Actions) — только в App Router.
  • Данные из getStaticProps/getServerSideProps сериализуются в HTML (__NEXT_DATA__) — не передавай лишнего и секретов.
  • getServerSideProps блокирует ответ до получения всех данных — нет стриминга.

Мини-шпаргалка

getStaticProps → SSG (+ revalidate = ISR), notFound / redirect
getStaticPaths → paths + fallback: false | true | 'blocking'
getServerSideProps → SSR на каждый запрос, req/res
_app → обёртка и провайдеры; _document → <html>/<body>
pages/api → API Routes; next/router; next/head

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам