Что происходит с коллекцией в Hibernate при вызове hashCode внутри транзакции, если entity является ключом с переопределенными equals и hashCode

Что проверяют

Знаете ли вы, что у сущности hashCode обязан быть стабильным на всём жизненном цикле, и понимаете ли, почему сгенерированный базой идентификатор для этого не годится. Вопрос сразу про две темы: контракт equals и hashCode и состояния сущности.

Как отвечать

• Сценарий, о котором спрашивают: объект кладут в HashSet или в ключи HashMap, пока он ещё новый и id равен null. Хеш считается по null, объект попадает в свою корзину. Дальше внутри транзакции проходит persist и flush, база выдаёт идентификатор, Hibernate проставляет его в поле, и hashCode того же объекта становится другим.
• Коллекция об этом не узнает: элемент остался в корзине, выбранной по старому хешу. contains и remove возвращают отрицательный ответ: обходом объект виден, а достать или удалить его нельзя. С ключом HashMap то же самое: значение лежит, по ключу не находится.
• Отсюда правило: hashCode не должен зависеть ни от изменяемых полей, ни от сгенерированного идентификатора. Рабочие варианты: константа от класса, естественный ключ из предметной области или UUID, присвоенный в конструкторе до сохранения. equals при этом может сравнивать по id с проверкой на null.
• Ленивая загрузка добавляет свой слой: у прокси поля пустые, пока не сработал геттер. Поэтому в equals и hashCode обращаются через геттеры, а тип сверяют через instanceof, иначе getClass() у прокси не совпадёт с классом сущности.

Где спотыкаются

Советуют учитывать в equals и hashCode все поля, как для обычного объекта переноса данных. Для сущности это прямой путь к описанной поломке: любое изменение поля внутри транзакции переставляет объект относительно корзин, и коллекция его теряет.

Второе: приплетают кэш Hibernate, будто из-за неверного hashCode в нём окажутся устаревшие данные. Кэш первого уровня адресует сущности по имени типа и идентификатору, а не через equals, и с этой ошибкой не связан вовсе.

Третье: не учитывают, что hashCode сущности может потянуть за собой ленивую коллекцию, а вне сессии вылетит LazyInitializationException. Особенно неприятно со связью на Set сущностей: чтобы её собрать, Hibernate позовёт hashCode у каждого элемента.