Перейти к содержимому
Учи.Онлайн Выбрать школу
Статья

GraphQL для бэкендера и фронтендера: схема, запросы и когда он лучше REST

GraphQL — язык запросов к API, в котором клиент сам перечисляет нужные поля, а сервер возвращает JSON ровно такой формы. Бэкендер описывает схему: типы данных, связи между ними и операции — query для чтения, mutation для изменений, subscription для событий в реальном времени. Затем он пишет резолверы, то есть функции, которые достают каждое поле из базы или другого сервиса. Фронтендер составляет запросы под экран и получает данные одним обращением к адресу /graphql. Освоить придётся схему и типы, резолверы, пакетную загрузку против проблемы N+1, ограничение тяжёлых запросов и обработку ошибок.

Автор: редакция Учи.ОнлайнОтветственный редактор: Дмитрий Игнатьев
Содержание
Иллюстрация к статье: GraphQL для бэкендера и фронтендера: схема, запросы и когда он лучше REST

Главное заблуждение новичков — что GraphQL сам по себе ускоряет работу с данными. Это лишь слой между клиентом и вашим кодом: он проверяет запрос по схеме и вызывает резолверы. Если резолвер для каждой из двадцати книг отдельно ходит в базу за автором, сервер сделает двадцать один запрос. Поэтому фронтендер учится писать запросы и кэшировать ответы, а бэкендер — не уронить сервер этими запросами.

Схема и типы: договор между клиентом и сервером

Работа начинается со схемы на языке SDL. Тип перечисляет поля, восклицательный знак означает «не может быть null», квадратные скобки — список. Корневые типы Query, Mutation и Subscription задают точки входа. Схема заменяет документацию: по запросу интроспекции GraphiQL подсказывает поля при наборе, а генераторы кода строят по ней типы TypeScript.

Query читает данные, mutation меняет их, subscription держит соединение, обычно WebSocket, и присылает событие, например новый отзыв. Текущая редакция спецификации — September 2025, реализации есть почти для всех языков: Apollo Server на Node.js, Strawberry на Python, gqlgen на Go.

Учебный пример: карточка книги одним запросом

Ситуация учебная. Книжный магазин показывает карточку книги: название, автор и три отзыва. При REST приложение сделало бы три запроса — /books/7, /authors/12, /books/7/reviews — с лишними полями. Бэкендер описывает схему:

type Book {
  id: ID!
  title: String!
  author: Author!
  reviews(first: Int = 5): [Review!]!
}
type Author { id: ID!  name: String!  books: [Book!]! }
type Review { id: ID!  stars: Int!  text: String! }

type Query {
  book(id: ID!): Book
  books(first: Int = 20): [Book!]!
}
type Mutation {
  addReview(bookId: ID!, stars: Int!, text: String!): Review!
}

Фронтендер пишет запрос под экран и передаёт идентификатор переменной:

query BookPage($id: ID!) {
  book(id: $id) {
    title
    author { name }
    reviews(first: 3) { stars text }
  }
}

Ответ повторяет форму запроса. Если дизайнер добавит на экран год издания, бэкендер добавит поле в схему, фронтендер — в запрос, и новая версия API не понадобится.

Резолверы и проблема N+1

У каждого поля есть резолвер. Для Query.books он делает один запрос к базе, а для Book.author вызывается отдельно для каждой книги. Список из двадцати книг с авторами превращается в 1 + 20 запросов — это и есть проблема N+1.

Стандартное решение — DataLoader: библиотека копит идентификаторы, запрошенные за один такт выполнения, и вызывает вашу функцию один раз со всем списком.

const authorLoader = new DataLoader(async (ids) => {
  const rows = await db.authors.findMany({ where: { id: { in: ids } } });
  return ids.map((id) => rows.find((a) => a.id === id) ?? null);
});

const resolvers = {
  Book: { author: (book, _args, ctx) => ctx.authorLoader.load(book.authorId) },
};

Две детали ломают решение чаще всего. Функция обязана вернуть результаты в том же порядке и в том же количестве, что и пришедшие идентификаторы, иначе книги получат чужих авторов. А загрузчик создают заново на каждый запрос и кладут в контекст: у него есть кэш, и общий на всё приложение загрузчик начнёт отдавать одному пользователю данные, загруженные для другого.

Что происходит, когда одно поле падает

В REST ошибка обычно означает код 404 или 500. В GraphQL ответ может быть частичным: в data — то, что удалось получить, в errors — сбои с путём до поля. Как далеко распространится сбой, решают восклицательные знаки в схеме.

Раздел «Handling Execution Errors» главы об исполнении спецификации September 2025 устроен так. Поле, в котором произошла ошибка, становится null. Если поле объявлено как Non-Null, null там невозможен, и ошибка переходит к родителю. Родитель, допускающий null, становится null, а Non-Null-родитель передаёт ошибку выше. Если вся цепочка от корня до поля состоит из Non-Null-типов, data целиком должна стать null.

В нашей схеме это выглядит так. Сервис авторов не ответил, резолвер author выбросил исключение. Поле объявлено как Author!, поэтому null передаётся книге. Элементы списка объявлены как Book!, а сам список — как [Book!]!, и ошибка поднимается до корня. Итог: из-за одного автора клиент не получает ни одной из двадцати книг, а в ответе стоит "data": null. Если объявить поле как author: Author, на экране будут все книги и пустое место у одной. Практическое правило: восклицательный знак ставят на поля, которые берутся из той же записи (id, title), и не ставят на поля, зависящие от внешних сервисов и отдельных запросов.

Глубина и стоимость запроса

Связь «автор — книги — автор» позволяет написать запрос на десять уровней вложенности, где каждый уровень умножает обращения к базе. Клиент вправе прислать всё, что проходит по схеме, поэтому защиту ставят на сервере в несколько слоёв.

Ограничение глубины отклоняет слишком вложенные запросы: в Strawberry для этого есть расширение QueryDepthLimiter, для graphql-js — пакеты вроде graphql-depth-limit. Анализ стоимости точнее: полям назначают веса, списки умножают на аргумент first, и запрос дороже порога не выполняется. Аргумент first получает верхний предел, резолверы — тайм-ауты. Если API обслуживает только ваши приложения, надёжнее сохранённые запросы: сервер принимает лишь заранее зарегистрированные тексты или их хэши.

GraphQL или REST

GraphQL выигрывает, когда у одних данных несколько клиентов с разными экранами — веб, iOS, Android, — когда данные собираются из нескольких сервисов и когда интерфейс часто меняется. Строгая схема и сгенерированные типы снимают споры о формате данных между фронтендом и бэкендом.

REST проще для плоских ресурсов с операциями создания, чтения, изменения и удаления, для загрузки файлов и вебхуков. Публичному API с кэшированием на CDN он тоже удобнее: ответ на GET кэшируется средствами HTTP, а GraphQL-запросы обычно идут методом POST на один адрес, и кэш переезжает в клиент — Apollo Client хранит объекты по типу и id. По рабочему черновику спецификации GraphQL over HTTP мутации методом GET выполнять нельзя, для такого запроса рекомендован код 405. Многие команды сочетают подходы: GraphQL-шлюз для своих клиентов поверх внутренних REST-сервисов.

С чего начать и в каком порядке осваивать

Порядок ниже идёт от того, что видит клиент, к тому, что происходит на сервере. Сначала важно почувствовать запросы и схему на готовом API, потом строить свой сервер, и только затем браться за производительность и защиту: без работающих резолверов в N+1 и стоимости запросов разбираться не на чем. Нужны уверенный JavaScript или Python, основы HTTP и JSON, базовый SQL.

  1. Запросы, переменные и фрагменты к публичному GraphQL API через GraphiQL или Postman.
  2. Схема на SDL: скалярные типы, Non-Null, списки, enum, input-типы для мутаций.
  3. Свой сервер на Apollo Server или Strawberry с резолверами к базе.
  4. DataLoader, пагинация через курсоры, ограничение глубины и стоимости.
  5. Подписки через WebSocket и клиентская часть: Apollo Client, генерация типов.

Упражнения и типичные ошибки

Хорошее упражнение — пример с книгами на своём сервере. Включите логирование SQL, запросите двадцать книг с авторами и посчитайте запросы к базе, подключите DataLoader и проверьте, что их стало два. Имитируйте сбой сервиса авторов с Author! и без восклицательного знака и сравните data. Пошлите запрос глубиной в восемь уровней — сервер должен его отклонить.

Частые ошибки новичков: схема копирует таблицы базы вместо экранов, мутации возвращают Boolean вместо изменённого объекта, права проверяют в одном резолвере и забывают про соседний путь к тем же данным. Ещё одна ловушка — считать код 200 успехом, не заглядывая в errors.

На бэкенде на Python GraphQL встречается как часть работы с API. На курсе Skillbox «FastAPI» GraphQL стоит в заключительных темах вместе с WebSocket, чатом и рефакторингом; основная часть программы — сам фреймворк, базы и тесты, а на входе ждут уверенного Python.

Открыть курс «Обучение FastAPI»

Чему учат на курсах

Отдельных онлайн-курсов по GraphQL в каталоге Учи.Онлайн нет: он входит в программы по бэкенду и Node.js одним модулем рядом с REST и WebSocket. Смотрите, есть ли практика с собственной схемой, а не только знакомство с синтаксисом.

Фронтендеру, который хочет писать и серверную часть, подходит онлайн-курс TeachMeSkills «Node.js для Front End»: четыре месяца занятий по вечерам два раза в неделю. В блоке о взаимодействии с клиентами разбирают REST API, GraphQL и WebSockets, дальше идут NestJS, PostgreSQL и MongoDB, авторизация на JWT, Docker и дипломный проект с защитой.

Если JavaScript нужен с нуля, GraphQL окажется ближе к концу пути: без уверенного языка схема и резолверы превращаются в заучивание шаблонов.

Так устроен онлайн-курс Eduson Academy «JavaScript-разработчик», прежде называвшийся «Node.js-разработчик»: GraphQL входит в модуль «Сервер и API» вместе с REST API и WebSocket, срок обучения — от 8,5 месяца. Обзор на сайте помечен как архивный, курса нет в последнем каталоге школы, поэтому наличие программы, состав модуля и цену уточните у школы перед оплатой.

Как навык влияет на доход

GraphQL почти никогда не бывает отдельной должностью: это строка в требованиях к бэкенд-, фронтенд- и фулстек-разработчикам. В калькуляторе зарплат Хабр Карьеры в середине октября 2026 года по всем IT-специалистам, указавшим GraphQL, значится зарплата 270 550 ₽ по 36 анкетам — все регионы, уровни и специальности вместе, период на странице не указан. Это данные анкет, а не предложения в вакансиях, и выборка мала: сравнивать её с отдельными специальностями нельзя.

Платят не за синтаксис, а за задачи: API для нескольких клиентов, шлюз над микросервисами, производительность под нагрузкой. Чтобы оценить рынок, отфильтруйте вакансии по языку и уровню и посмотрите, обязателен ли GraphQL или указан как плюс.

Как выбрать обучение

Перед оплатой проверьте, есть ли в программе собственная схема и сервер, разбор N+1, ограничение запросов и работа с ошибками. Сравнить школы по формату, поддержке и проверке домашних заданий поможет общий рейтинг онлайн-школ по бэкенд-разработке: он охватывает разные языки, так что программы с GraphQL придётся выбирать по описанию. А до оплаты соберите пример с книгами по официальной документации: если вы сами нашли и убрали N+1, база для курса у вас есть.