Когда нужно изменять значение поля serialVersionUID?

Значение serialVersionUID следует изменять при изменении несовместимым образом структуры сериализуемого класса. Это означает, что изменения ломают обратную совместимость формата сериализованных данных.

Примеры таких изменений:

• Удаление полей.
• Изменение типа поля.
• Изменение модификаторов static или transient для полей.
• Изменение иерархии классов (добавление или удаление суперклассов).
• Изменение сигнатуры или удаление стандартных методов сериализации (readObject, writeObject, readResolve, writeReplace).

Изменение serialVersionUID явно указывает JVM, что загружаемые сериализованные данные относятся к старой версии класса и несовместимы с текущей, предотвращая InvalidClassException. Если serialVersionUID не изменен, JVM будет считать версии классов совместимыми, что может привести к некорректному поведению или ошибкам во время десериализации из-за несовпадения структур.

Некоторые изменения, как правило, не требуют изменения serialVersionUID (если только они не влияют на стандартные методы сериализации):

• Добавление новых полей (если они не помечены final).
• Добавление или удаление методов.
• Изменение модификаторов доступа полей (кроме static и transient).

Рекомендуется явно указывать serialVersionUID в сериализуемых классах. Это дает контроль над совместимостью версий. Если поле не указано, JVM генерирует его значение на основе характеристик класса, что может привести к проблемам совместимости при незначительных изменениях кода, которые, тем не менее, меняют алгоритм генерации ID. Типичное использование:

java

При несовместимом изменении класса значение 1L следует изменить на другое, например, сгенерированное утилитой serialver или инкрементированное (2L).