Resolvendo o erro "Object References Unsaved Transient Instance" do Hibernate

Ao tentar salvar um objeto usando o Hibernate, você pode encontrar o seguinte erro:

object references an unsaved transient instance - save the transient instance before flushing

Compreendendo o Erro

Este erro indica que você tem uma coleção em sua entidade que contém um ou mais itens que não estão presentes no banco de dados. O Hibernate exige que todas as entidades referenciadas por outras entidades sejam salvas (persistidas) no banco de dados ou marcadas como transitórias.

Resolução

A solução para este erro é especificar a opção em cascata para o mapeamento da sua coleção. Você pode fazer isso usando XML ou anotações:

XML:

    ...

Anotações:

@OneToMany(cascade = CascadeType.ALL)
private List collectionName;

Explanation

Ao especificar a opção cascade="all" ou CascadeType.ALL, você instrui o Hibernate a salvar todas as entidades na coleção ao banco de dados ao salvar a entidade pai. Isso garante que todas as entidades referenciadas persistam no banco de dados e resolve o erro.