Spring Boot遍历同父类子类列表时触发ClassCastException问题

问题原因 #

这个异常的核心是Hibernate懒加载代理机制引发的类型混淆：

• DirectorJPA和WriterJPA均继承自PersonJPA，Hibernate默认会为懒加载实体生成基于父类PersonJPA的动态代理对象。
• 当先遍历directors集合时，Hibernate会将代理实例初始化为DirectorJPA类型；后续遍历writers集合时，Hibernate尝试复用同一个代理实例，却要强制转换为WriterJPA，最终抛出ClassCastException。

可行解决方案 #

方案1：为关联集合指定Fetch模式，避免代理复用 #

在MediaJPA的两个多对多关联字段上添加@Fetch(FetchMode.SELECT)，强制Hibernate为每个集合执行独立查询，加载对应类型的真实对象：

@ManyToMany
@Fetch(FetchMode.SELECT)
@JoinTable(
        name = "media_directors",
        joinColumns = @JoinColumn(name = "media_id", referencedColumnName = "id"),
        inverseJoinColumns = @JoinColumn(name = "director_id", referencedColumnName = "person_id"))
private List<DirectorJPA> directors = new ArrayList<>();

@ManyToMany
@Fetch(FetchMode.SELECT)
@JoinTable(
        name = "media_writers",
        joinColumns = @JoinColumn(name = "media_id", referencedColumnName = "id"),
        inverseJoinColumns = @JoinColumn(name = "writer_id", referencedColumnName = "person_id"))
private List<WriterJPA> writers = new ArrayList<>();

方案2：通过JOIN FETCH提前加载关联集合 #

在IMovieRepository中自定义查询方法，使用JOIN FETCH同时加载directors和writers集合，彻底避免懒加载代理：

@Repository
public interface IMovieRepository extends JpaRepository<MovieJPA, Long>{
    @Query("SELECT m FROM Movie m JOIN FETCH m.directors JOIN FETCH m.writers")
    List<MovieJPA> findAllWithDirectorsAndWriters();
}

服务类中调用该方法：

public void getAllMoviesTest() {
    for (MovieJPA jpa : movieRepo.findAllWithDirectorsAndWriters()) {
        for (DirectorJPA director : jpa.getDirectors()) {
            System.out.println("Director: " + director.getFirstName() + " " + director.getLastName());
        }
        for (WriterJPA writer : jpa.getWriters()) {
            System.out.println("Writer:" + writer.getFirstName() + " " + writer.getLastName());
        }
    }
}

方案3：强制初始化集合（临时应急方案） #

在遍历前手动触发集合初始化，让Hibernate加载真实对象而非代理：

import org.hibernate.Hibernate;

public void getAllMoviesTest() {
    for (MovieJPA jpa : movieRepo.findAll()) {
        // 强制初始化两个集合
        Hibernate.initialize(jpa.getDirectors());
        Hibernate.initialize(jpa.getWriters());
        
        for (DirectorJPA director : jpa.getDirectors()) {
            System.out.println("Director: " + director.getFirstName() + " " + director.getLastName());
        }
        for (WriterJPA writer : jpa.getWriters()) {
            System.out.println("Writer:" + writer.getFirstName() + " " + writer.getLastName());
        }
    }
}

注意事项 #

• 方案1和方案2是长期优化的首选，方案3仅适合临时调试或特殊场景。
• 使用方案2时需注意，JOIN FETCH可能产生笛卡尔积，数据量较大时需配合分页或其他查询优化手段。

内容的提问来源于stack exchange，提问作者JuiceWizard