Не начинайте с глобального network-only и очистки всего cache. Сначала сравните три значения одного объекта: response mutation, запись normalized cache и свежий query с сервера. Если сервер уже возвращает старое updatedAt, клиентский refetch не поможет; если network response новый, а UI старый, ищите identity объекта, field policy или локальное состояние компонента.
Apollo Client нормализует результаты и по умолчанию связывает объекты через __typename и идентификатор. Mutation, которая возвращает только success=true, не сообщает cache, какие поля изменились. Mutation с id, __typename и новым значением может обновить существующую запись, но не обязана сама вставить объект в каждый отфильтрованный список.
Один updatedAt проходит по пяти слоям
| Слой | Что сравнить | Если значение старое |
|---|---|---|
| Mutation response | id, __typename, updatedAt | Resolver/read-after-write |
| Normalized cache | Entity cache key и fields | keyFields/merge policy |
| Active query | Network response и fetchPolicy | HTTP/CDN или backend |
| Connection/list | edges/nodes membership | Нужен update списка |
| React component | Props против local state | Копия state не синхронизирована |
Mutation должна вернуть объект, который изменила
mutation RenameProject($id: ID!, $name: String!) {
renameProject(id: $id, name: $name) {
project {
__typename
id
name
updatedAt
}
}
}Apollo рекомендует включать изменённые объекты в mutation response, чтобы cache мог нормализовать их по __typename и keyFields. Если backend возвращает другой ID format, пропускает id или тип настроен с keyFields: false, новая запись не объединится со старой. Проверьте cache key вроде Project:42 до ручного writeQuery.
Объект обновился, а список остался прежним
Изменение name у уже присутствующего Project обычно отражается через общую entity. Но create/delete, смена filter category и pagination меняют состав connection. Cache не знает, в какие из множества списков включить новый объект и из каких удалить старый. Здесь нужен точный cache.modify/update либо refetch queries, чья membership зависит от mutation.
- Для одного активного списка применить cache.modify с дедупликацией по reference.
- Для сложных server-side filters запросить конкретные active queries заново.
- Не добавлять item во все connections с тем же field name без учёта arguments.
- После delete удалить entity и ссылки, но учитывать optimistic layer.
- Согласовать merge/read policy для cursor pagination.
- Проверить, что variables refetch совпадают с текущим экраном.
Refetch — инструмент проверки, а не универсальный ремонт
refetchQueries полезен, когда сервер единственный надёжно рассчитывает список. Указывайте операции по DocumentNode или уникальному operation name; Apollo повторяет их с последними variables. Массовый refetch всех queries увеличивает трафик, создаёт гонки UI и скрывает неверные keyFields. Сначала точечно подтвердите, что свежий network response действительно исправляет экран.
Если awaitRefetchQueries не включён, mutation promise может завершиться до окончания refetch. UI, который сразу закрывает modal и читает данные, иногда показывает короткий откат. Решите, нужно ли ждать query, использовать optimistic response или показать промежуточное состояние; это UX-контракт, а не повод добавлять произвольную задержку.
Когда даже network-only приносит старое значение
- Проверить response headers и HTTP cache/CDN policy для POST/GET persisted query.
- Сравнить resolver response с записью основной базы по одному ID.
- Очистить только request-scoped DataLoader и проверить его lifecycle.
- Найти shared Redis/resolver cache key и tenant/version dimensions.
- Проверить replica lag или асинхронный read model.
- Повторить query с correlation ID после подтверждённого commit.
- Не отключать все кеши, пока не найден слой, вернувший старое updatedAt.
DataLoader обычно создают на один request: общий экземпляр между пользователями и запросами может удерживать старое значение и даже смешивать security scopes. Для shared cache key включают tenant и все параметры, влияющие на результат, а invalidation выполняют после успешного commit. При event-driven read model честно показывают пользователю состояние обновления и измеряют задержку проекции.
Проверка должна пережить два быстрых изменения
Сделайте A→B→C без reload и искусственно задержите первый response. Последнее подтверждённое изменение должно остаться C, список не должен получить дубль, а переход на другой tenant или filter не должен показывать прежний объект. Затем перезапустите приложение и убедитесь, что server truth совпадает. Для разбора подготовьте schema фрагмент, typePolicies, две operations с variables, cache extract только по обезличенному ID и сетевые ответы без tokens.