Почему состояние не обновляется в 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: "Алматы" },
});
И совет на будущее: чем площе состояние, тем меньше таких багов. Если приходится писать три вложенных спреда — это сигнал, что структуру стоит разложить попроще.
Быстрая диагностика
По порядку, тридцать секунд:
- Есть ли
push/splice/sort/ присваивание в поле рядом с сеттером? → причина 1. - Считаешь новое значение из старого дважды за обработчик? → причина 2.
- Есть вложенные объекты и спред только сверху? → причина 3.
- Ничего не подошло? Проверь, что смотришь на тот же компонент — иногда состояние живёт выше по дереву, а перерисовки ждут ниже. Тут помогает React DevTools: выдели компонент и посмотри его текущий стейт напрямую.
Почему React просто не сравнивает содержимое?
Из-за скорости. Глубокое сравнение больших объектов на каждое обновление стоило бы дорого и делалось бы постоянно. Сравнение ссылок — одна операция. Расплата за скорость — необходимость возвращать новые объекты; это и есть тот самый принцип «состояние неизменяемо», о котором пишут во всех гайдах по React.
Экран не обновился — а может, дело не в стейте?
Бывает. Если не обновляется вообще ничего и в консоли ошибка — скорее всего, компонент упал при рендере, и это уже другая история: почему страница пустая и белая. Если же данные в React DevTools новые, а в DOM старые — вот это как раз симптом из статьи выше.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





