Гайды

Почему состояние не обновляется в React — и при чём тут сравнение по ссылке

Иллюстрация: коробка с новым содержимым, но старой биркой снаружи

Симптом знакомый до боли. Ты добавляешь элемент в массив, ставишь console.log — в консоли элемент есть. На экране его нет. React как будто не заметил.

Он и правда не заметил, и на то есть точная причина. React сравнивает старое и новое состояние по ссылке, а не по содержимому. Ты изменил содержимое коробки, но подсунул ему ту же самую коробку — и он честно сказал: «ничего не поменялось, перерисовывать не буду».

Разберём три причины, которые дают этот симптом. Первая — самая частая.

Причина 1. Ты мутируешь массив вместо того, чтобы его заменить

Вот классический код, который не работает:

function handleAdd(title) {
  todos.push({ id: nextId++, title, done: false }); // ❌
  setTodos(todos);
}

push меняет тот же самый массив. Ты передаёшь в setTodos ровно ту ссылку, что там уже лежала.

В документации React это сформулировано прямо: React игнорирует обновление, если новое состояние равно предыдущему по сравнению Object.is. Ты вернул тот же объект — обновление отброшено.

Как проверить. Найди в обработчиках всё, что меняет данные на месте: push, pop, splice, sort, reverse, а для объектов — присваивание в поле (todo.done = true). Если такое есть рядом с setState — причина найдена.

Как починить. Не менять, а создавать новое:

// Добавить
setTodos([...todos, { id: nextId++, title, done: false }]);

// Удалить
setTodos(todos.filter((t) => t.id !== id));

// Изменить один элемент
setTodos(todos.map((t) => (t.id === id ? { ...t, done: true } : t)));

Правило простое: map, filter и спред ... — можно; push, splice, sort — нельзя. Первые возвращают новый массив, вторые правят старый. Если очень нужен sort, сначала скопируй: [...todos].sort(...).

Причина 2. Стейт — это снимок, а не живая переменная

Второй сценарий: мутаций нет, всё замещается честно, но значение отстаёт на шаг.

function handleClick() {
  setCount(count + 1);
  console.log(count); // старое значение!
}

Это не баг. Внутри одного рендера count — константа, снимок на момент отрисовки. setCount не меняет её, а планирует следующий рендер с новым значением.

Отсюда более коварная версия той же ошибки:

setCount(count + 1);
setCount(count + 1); // ❌ будет +1, а не +2

Оба вызова читают одно и то же старое count. Второй просто перезаписывает первый.

Как проверить. Считаешь новое значение на основе старого — и делаешь это дважды за обработчик или внутри асинхронного колбэка? Значит, это твой случай.

Как починить. Передавать в сеттер функцию — она получит актуальное значение на момент применения:

setCount((c) => c + 1);
setCount((c) => c + 1); // ✅ теперь +2

Тот же приём работает для массивов: setTodos((prev) => [...prev, newTodo]).

Причина 3. Спред скопировал только верхний уровень

Самая обидная из трёх, потому что выглядит правильно:

setUser({ ...user, address: user.address }); // ❌ адрес — тот же объект

Спред делает поверхностную копию. Верхний уровень — новый объект, а всё вложенное осталось теми же ссылками. Меняешь user.address.city — и меняешь его в старом состоянии тоже.

Как проверить. Есть ли у тебя в состоянии объект внутри объекта или массив объектов? Копируешь ли ты только внешний уровень? Симптом характерный: часть интерфейса обновляется, а вложенная — нет.

Как починить. Копировать каждый уровень, который меняешь:

setUser({
  ...user,
  address: { ...user.address, city: "Алматы" },
});

И совет на будущее: чем площе состояние, тем меньше таких багов. Если приходится писать три вложенных спреда — это сигнал, что структуру стоит разложить попроще.

Быстрая диагностика

По порядку, тридцать секунд:

  1. Есть ли push / splice / sort / присваивание в поле рядом с сеттером? → причина 1.
  2. Считаешь новое значение из старого дважды за обработчик? → причина 2.
  3. Есть вложенные объекты и спред только сверху? → причина 3.
  4. Ничего не подошло? Проверь, что смотришь на тот же компонент — иногда состояние живёт выше по дереву, а перерисовки ждут ниже. Тут помогает React DevTools: выдели компонент и посмотри его текущий стейт напрямую.

Почему React просто не сравнивает содержимое?

Из-за скорости. Глубокое сравнение больших объектов на каждое обновление стоило бы дорого и делалось бы постоянно. Сравнение ссылок — одна операция. Расплата за скорость — необходимость возвращать новые объекты; это и есть тот самый принцип «состояние неизменяемо», о котором пишут во всех гайдах по React.

Экран не обновился — а может, дело не в стейте?

Бывает. Если не обновляется вообще ничего и в консоли ошибка — скорее всего, компонент упал при рендере, и это уже другая история: почему страница пустая и белая. Если же данные в React DevTools новые, а в DOM старые — вот это как раз симптом из статьи выше.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →