Дубль на границе страниц почти всегда означает потерю позиции. Сортировка только по `createdAt` неоднозначна, если несколько записей имеют одинаковое время; `OFFSET` смещается, когда перед второй страницей добавили или удалили строку; клиентский cache может повторно append уже известный node. Сравните `id` последнего edge первой страницы с первым edge второй и декодируйте cursor только на сервере.

Надёжная позиция описывает весь порядок. Для ленты `created_at DESC` добавьте уникальный tie-breaker `id DESC`, положите оба значения в непрозрачный cursor и продолжайте строгим условием «меньше пары». Cursor не обязан быть зашифрованным, но клиент должен считать его opaque и не собирать самостоятельно.

Один симптом возникает в трёх местах

НаблюдениеИсточник дубляПроверка
Повтор есть уже в raw response page 2Resolver/querySQL и cursor predicate
Raw responses уникальны, UI повторяет nodeCache mergePolicy и keyFields/id
Повтор появляется только при новых записяхOffset или меняющийся sortВставка между page 1 и page 2
Повторяют записи с одинаковым временемНет tie-breakerПолный ORDER BY и cursor payload
Cursor одного фильтра применён к другомуPosition не связана с query shapeFilter/sort fingerprint

Relay Cursor Connections требует согласованного порядка от страницы к странице и передаёт cursor каждого edge вместе с `pageInfo`. Спецификация не выбирает за вас поля базы: стабильность обеспечивают resolver и источник данных.

Пара значений делает порядок однозначным

ORDER BY created_at DESC, id DESC

-- cursor хранит last_created_at и last_id
WHERE (created_at, id) < (:last_created_at, :last_id)
ORDER BY created_at DESC, id DESC
LIMIT :first_plus_one

# endCursor = opaqueEncode(created_at, id, sort, filterVersion)

Синтаксис tuple comparison показан для СУБД, которая его поддерживает; в другом движке разверните условие в `created_at < t OR (created_at = t AND id < id0)`. Для ASC знак меняется. Обязательно сравните `NULL` semantics и collation, если сортировка идёт не по обязательным timestamp/ID.

Cursor относится к конкретной форме запроса

  • Не принимайте `after` от другого sort order или набора фильтров.
  • Версионируйте payload, чтобы смена формата завершалась понятной ошибкой.
  • Подписывайте cursor, если нельзя позволять клиенту подменять tenant или границу.
  • Ограничьте `first` на сервере и запрашивайте на один edge больше для `hasNextPage`.
  • Не включайте в cursor персональные данные и внутренние секреты.

Курсор не создаёт snapshot автоматически. Если поле сортировки записи изменилось между запросами, node может переместиться относительно сохранённой границы. Для бесконечной ленты это часто приемлемо; для экспорта «ровно один раз» нужна snapshot/версия набора или отдельный стабильный job, а не обычная UI-пагинация.

Client cache обязан различать connection и node

Connection определяется не только именем поля, но и аргументами фильтра/сортировки. При `fetchMore` обновляйте `after` значением `pageInfo.endCursor`, а merge делайте по стабильному `node.id`. Дедупликация на клиенте полезна как защита интерфейса, но не должна скрывать ошибку сервера: telemetry должна считать повторные ID между соседними raw pages.

Не используйте индекс элемента как cache key. При вставке в начало индексы сдвинутся, и UI либо повторит строки, либо покажет данные одного node в карточке другого. Global ID должен быть стабильным в рамках типов и прав доступа вашего schema.

Тест меняет набор между двумя запросами

  1. Создать записи с одинаковым `created_at` и разными ID.
  2. Запросить `first: 3`, сохранить все edge cursors и `endCursor`.
  3. Вставить новую запись перед первой страницей и изменить запись после границы.
  4. Запросить вторую страницу с прежним `after` и теми же filter/sort.
  5. Проверить отсутствие повторов, порядок, `hasNextPage` и merge в кеше.

Для разбора достаточно schema connection, variables двух запросов, обезличенных `id/createdAt`, cursor payload на стороне сервера, SQL/ORM ordering и cache policy. Authorization headers, пользовательские поля и production cursor целиком лучше заменить тестовыми значениями.

Проверенные источники