Почему Next.js считается fullstack-фреймворком
На этой странице
Fullstack-фреймворк дает инструменты и для пользовательского интерфейса, и для серверной части. В Next.js обе части можно разрабатывать в одном проекте.
Вопрос
Какие серверные задачи способен выполнять Next.js помимо отображения React-компонентов?
Основная идея
Frontend показывает интерфейс и обрабатывает действия пользователя. Backend проверяет права, получает данные, сохраняет изменения и отвечает на HTTP-запросы.
В App Router эти задачи можно распределить так:
- Server Components получают данные и подготавливают интерфейс на сервере.
- Route Handlers принимают HTTP-запросы и возвращают JSON или другой ответ.
- Server Actions обрабатывают действия, например отправку формы, выполняясь на сервере.
- Client Components обеспечивают состояние, события и работу с браузерными API.
Next.js не содержит собственную базу данных. Он позволяет подключить подходящее хранилище или внешний сервис.
Один проект — две среды выполнения
┌──────────────── Next.js-проект ────────────────┐
│ │
СЕРВЕР (Node.js) │ Server Components — данные из БД, HTML │
│ Route Handlers — REST/вебхуки (route.ts) │
│ Server Actions — мутации из форм │
│ proxy.ts — редиректы, проверка cookie│
│ секреты, process.env.DB_URL │
─ ─ ─ ─ ─ ─ ─ ─ ─│─ ─ ─ ─ ─ ─ граница "use client" ─ ─ ─ ─ ─ ─ ─ ─│─
БРАУЗЕР │ Client Components — state, события, window │
│ только NEXT_PUBLIC_* переменные │
└─────────────────────────────────────────────────┘
│
внешнее: БД, очереди, платёжки, S3, Auth| Задача backend | Как в Next.js |
|---|---|
| Прочитать данные для страницы | await db.query(...) в Server Component |
| Изменить данные из формы | Server Action ("use server") |
| Публичный HTTP API, вебхуки | Route Handler (app/api/.../route.ts) |
| Аутентификация, сессии | Библиотеки (Auth.js, Better Auth, Clerk) + cookies |
| Фоновые задачи после ответа | after(), для долгих — внешняя очередь |
| База данных | Подключается: PostgreSQL + Drizzle/Prisma и т. п. |
Пример: HTTP-обработчик и страница
// app/api/health/route.ts
export async function GET() {
return Response.json({ status: "ok", service: "book-shop" });
}// app/page.tsx
export default function HomePage() {
return (
<main>
<h1>Книжный магазин</h1>
<a href="/api/health">Проверить ответ сервера</a>
</main>
);
}Главная страница показывает интерфейс. Открыв /api/health, пользователь увидит JSON с состоянием сервиса. В примере нет базы данных: обработчик возвращает заранее заданный ответ, поэтому его можно проверить сразу.
Это Route Handler App Router. В Pages Router аналогичный HTTP-интерфейс называется API Route и создается в pages/api с другой сигнатурой обработчика.
Что важно помнить
Совместное расположение файлов не отменяет границу между сервером и браузером. Секретный API-ключ должен оставаться в серверном коде. Все данные, выведенные на страницу или возвращенные API, доступны получателю.
Серверная функция не проверяет права автоматически. Доступ пользователя и входные данные нужно проверять при каждой операции.
Сложная серверная система может оставаться отдельным приложением. Next.js часто выполняет только роль интерфейса и промежуточного сервера для него.
Мини-шпаргалка
- Next.js поддерживает интерфейс и серверные обработчики.
route.tsсоздает HTTP-ответ в App Router.- Server Action выполняет операцию на сервере.
- База данных и правила доступа требуют отдельной реализации.