Сначала верните воспроизводимость. Возьмите коммит до обновления, его lockfile и ту же версию Node; установите зависимости чисто. Затем повторите с новым lockfile. Если старый lockfile уже даёт поломку, причина не обязательно в заявленном пакете: мог измениться незакреплённый инструмент, браузер или конфигурация окружения.

npm ci предназначен для чистой установки из существующего lockfile и завершится ошибкой, если package.json с ним расходится. Зафиксируйте менеджер пакетов и его флаги в CI. Сравнивать два запуска после обычного install опасно: дерево может незаметно обновиться ещё раз.

Симптом указывает на нарушенный контракт

СимптомПроверьте первымЧастая причина
Поле не печатаетonChange и новый statevalue остаётся прежним
Значение очищаетсяundefined/null между renderпереход controlled в uncontrolled
Checkbox не меняетсяchecked и event payloadчитается value вместо checked
Курсор прыгаетнормализацию на каждый символstate переписывается форматтером
Работает нативный input, ломается UI-kitимя prop и сигнатуру callbackизменён adapter contract

React требует, чтобы controlled input получал строковый value или булев checked и синхронно обновлял backing value в onChange. Поле не должно переключаться между controlled и uncontrolled в течение жизни. Поэтому данные API нормализуют до render, а не временно передают null.

Инвариант поля помещается в короткий пример

const [name, setName] = useState('');

<input
  value={name ?? ''}
  onChange={event => setName(event.target.value)}
/>

// checkbox: checked={Boolean(enabled)}

Этот пример не предлагает ставить ?? везде и скрывать ошибку модели. Он показывает границу: компонент ввода всегда получает ожидаемый тип. Если сервер различает «не задано» и пустую строку, это различие сохраняют в доменной модели и преобразуют на границе формы.

У составного компонента откройте типы и migration guide новой версии. Один UI-kit вызывает onChange(event), другой — onValueChange(value), третий возвращает value вторым аргументом. Adapter должен преобразовать новый контракт в единый интерфейс формы; чтение event.target у строки даст undefined без явной ошибки TypeScript, если тип был ослаблен any.

Bisect делают по фактическому дереву зависимостей

  • Сохраните package.json, старый и новый lockfile, версии Node и package manager.
  • Сравните прямые и транзитивные версии вокруг формы, UI-kit и runtime.
  • Верните половину изменений, каждый раз выполняя чистую установку и один минимальный тест.
  • После найденного пакета прочитайте официальный upgrade guide и release notes.
  • Временный pin фиксирует инцидент, но рядом создаётся задача миграции с тестом.

Для React крупное обновление стоит проводить через рекомендованный промежуточный релиз и warnings; официальный guide для React 19 советует сначала перейти на React 18.3. Не смешивайте в одном коммите обновление runtime, form library, UI-kit и рефакторинг состояния: иначе поиск причины становится многомерным.

Курсор и IME проверяют реальное управление значением

Тест setValue не заменяет живой ввод. Наберите текст в середине строки, вставьте фрагмент, удалите символ, удерживайте клавишу и проверьте composition events для ввода на языках с IME. Форматирование денег и телефонов должно сохранять selection; преобразование регистра на каждый keystroke часто переставляет курсор.

Проверьте асинхронную валидацию. Поздний ответ не должен записывать в поле устаревшее значение. Храните request sequence или abort signal, а ошибку валидации отделяйте от value. Если сторонний компонент кеширует внутреннее состояние, убедитесь, что его key не меняется на каждом render и не вызывает remount.

Исправление подтверждается на двух версиях

  1. Создать минимальную форму без бизнес-обвязки и воспроизвести дефект на новой версии.
  2. Записать props, callback payload и state после одного символа.
  3. Исправить invariant или adapter и прогнать ввод, paste, clear, checkbox и IME.
  4. Запустить тест на закреплённой старой и целевой новой версии.
  5. Зафиксировать lockfile и добавить сценарий в CI до снятия временного pin.

В отчёт приложите минимальный компонент, версии пакетов, фрагмент lockfile и один лог перехода state без персональных данных. Скриншот замершего поля почти бесполезен: важен путь от пользовательского события до следующего value, который React получил при render.

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