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 |
|---|---|
false | 404 |
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 Router | App Router | |
|---|---|---|
| Компоненты | Все клиентские | Серверные по умолчанию |
| Данные | getStaticProps / getServerSideProps на уровне страницы | await в любом серверном компоненте |
| Layout | Один _app (+ ручные паттерны) | Вложенные layout.tsx, сохраняют состояние |
| Загрузка/ошибки | Вручную | loading.tsx, error.tsx, Suspense |
| Стриминг | Нет | Да |
| Мутации | API Routes + клиентский fetch | Server Actions |
| Метаданные | next/head | Metadata API |
| Навигация | next/router | next/navigation |
| Кэш | ISR через revalidate | use 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