Как исправить ошибку Hibernate "object references an unsaved transient instance" при сохранении связанных сущностей?

Причина ошибки и базовое решение

Ошибка возникает из-за того, что Hibernate не может разрешить ссылку на transient (не сохранённый) объект. В вашем коде Author author — это новый объект без ID, который ещё не был сохранён в базе данных. Когда вы пытаетесь сохранить Book, Hibernate проверяет все связи и обнаруживает, что author не является управляемым (persistent).

Ключевой момент: cascade на стороне @OneToMany в классе Author работает только при операциях над самим Author. Вы же сохраняете Book, а не Author. Каскадирование не "передаётся" обратно от дочерней сущности к родительской — оно работает только в направлении, указанном в аннотации.

Решение 1: Сохранять автора первым

Самый простой и явный способ — сначала сохранить Author, а затем Book:

Author author = new Author();
author.setName("Лев Толстой");
entityManager.persist(author); // Сначала сохраняем автора

Book book = new Book();
book.setTitle("Война и мир");
book.setAuthor(author);
entityManager.persist(book); // Теперь author — persistent, ошибки нет

Решение 2: Добавить cascade на @ManyToOne

Лучший способ — добавить каскадирование на обратную сторону связи:

@Entity
public class Book {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String title;
    
    @ManyToOne(cascade = CascadeType.PERSIST) // или CascadeType.ALL
    @JoinColumn(name = "author_id")
    private Author author;
}

Теперь при сохранении Book Hibernate автоматически сохранит и связанного Author. Работает это так:

• Hibernate видит, что author — transient
• Так как указан cascade = PERSIST, он выполняет persist(author) перед сохранением Book
• После этого author становится persistent, и книга сохраняется успешно

Решение 3: Использовать CascadeType.ALL

Если вы часто работаете с графом объектов целиком, используйте CascadeType.ALL:

@ManyToOne(cascade = CascadeType.ALL)
private Author author;

Это покроет все операции: persist, merge, remove, refresh, detach. Но будьте осторожны: remove будет удалять автора при удалении книги, что не всегда желательно.

Важные рекомендации

• Не злоупотребляйте CascadeType.ALL — явно указывайте только нужные типы каскадирования
• Всегда синхронизируйте обе стороны связи в Java-коде: author.getBooks().add(book); book.setAuthor(author);
• Проверяйте ID — если вы передаёте объект из другого контекста, убедитесь, что он не является transient (id == null)
• Используйте merge вместо persist для обновления существующих объектов

В вашем случае я рекомендую добавить cascade = CascadeType.PERSIST на связь @ManyToOne в классе Book. Это наиболее идиоматичное решение для Hibernate/JPA.

Author author = new Author();
author.setName("Лев Толстой");

Book book = new Book();
book.setTitle("Война и мир");
book.setAuthor(author);

entityManager.merge(book); // merge сохранит и автора, и книгу