Дубль на границе страниц почти всегда означает потерю позиции. Сортировка только по `createdAt` неоднозначна, если несколько записей имеют одинаковое время; `OFFSET` смещается, когда перед второй страницей добавили или удалили строку; клиентский cache может повторно append уже известный node. Сравните `id` последнего edge первой страницы с первым edge второй и декодируйте cursor только на сервере.
Надёжная позиция описывает весь порядок. Для ленты `created_at DESC` добавьте уникальный tie-breaker `id DESC`, положите оба значения в непрозрачный cursor и продолжайте строгим условием «меньше пары». Cursor не обязан быть зашифрованным, но клиент должен считать его opaque и не собирать самостоятельно.
Один симптом возникает в трёх местах
| Наблюдение | Источник дубля | Проверка |
|---|---|---|
| Повтор есть уже в raw response page 2 | Resolver/query | SQL и cursor predicate |
| Raw responses уникальны, UI повторяет node | Cache merge | Policy и keyFields/id |
| Повтор появляется только при новых записях | Offset или меняющийся sort | Вставка между page 1 и page 2 |
| Повторяют записи с одинаковым временем | Нет tie-breaker | Полный ORDER BY и cursor payload |
| Cursor одного фильтра применён к другому | Position не связана с query shape | Filter/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.
Тест меняет набор между двумя запросами
- Создать записи с одинаковым `created_at` и разными ID.
- Запросить `first: 3`, сохранить все edge cursors и `endCursor`.
- Вставить новую запись перед первой страницей и изменить запись после границы.
- Запросить вторую страницу с прежним `after` и теми же filter/sort.
- Проверить отсутствие повторов, порядок, `hasNextPage` и merge в кеше.
Для разбора достаточно schema connection, variables двух запросов, обезличенных `id/createdAt`, cursor payload на стороне сервера, SQL/ORM ordering и cache policy. Authorization headers, пользовательские поля и production cursor целиком лучше заменить тестовыми значениями.