Hibernate命名实体自动映射异常：分页查询返回错误实体

哥们，你遇到的这个问题根源在于两个实体的JPA映射配置冲突，以及错误地将DTO类当成实体类处理，咱们一步步拆解：

1. 核心问题：实体名称冲突 + 非法同表映射 #

你给Book和BookSummary都加了@Entity(name = "Book")，这直接违反了JPA基本规范——每个实体的名称必须唯一。Hibernate初始化SessionFactory时，会把实体名称作为唯一标识管理元数据，当两个实体共用同一个名称时，后加载的那个（大概率是BookSummary）会覆盖先加载的Book的元数据定义。

另外，你想让两个类映射到同一张数据库表，却没有使用JPA的继承策略（比如@Inheritance），这种“无继承关系的同表实体映射”本身不合法，Hibernate根本无法正确区分该实例化哪个实体类。

2. 为什么单个查询正常，分页查询异常？ #

• 单个主键查询（/books/{uuid}）：Spring Data JPA会直接根据BookRepository的泛型类型Book，调用EntityManager.find(Book.class, uuid)，此时Hibernate能精准定位到Book实体的元数据，所以返回正确的Book实例，序列化后包含publisher和type: "Book"。
• 分页查询（/books）：Spring Data JPA会生成JPQL查询语句select book from Book book（这里的Book是你设置的实体名称），但此时Hibernate元数据中，Book这个名称已经被BookSummary覆盖，查询返回的是BookSummary实例，自然没有publisher字段，且type为"BookSummary"。

3. 修复方案 #

方案一：把BookSummary改成DTO（推荐） #

既然BookSummary只是用来返回摘要信息，完全没必要定义成实体类，直接做成DTO即可：

// 去掉@Entity注解，这就是个普通的DTO类
public class BookSummary {
    private UUID uuid;
    private String title;
    private String author;
    private String type = "BookSummary";
    
    // 构造方法、Getter & Setter
}

然后在BookRepository中添加投影查询方法：

@Repository
public interface BookRepository extends PagingAndSortingRepository<Book, UUID> {
    Page<Book> findAll(Pageable pageable);
    
    // 投影查询，返回BookSummaryDTO
    @Query("select new com.yourpackage.BookSummary(b.uuid, b.title, b.author) from Book b")
    Page<BookSummary> findAllSummary(Pageable pageable);
}

最后修改Controller的分页接口：

@GetMapping
public Page<BookSummary> readSummary(Pageable pageable) {
    return bookRepository.findAllSummary(pageable);
}

方案二：修正实体映射（不推荐，仅用于理解） #

如果你非要把BookSummary作为实体，必须修复映射冲突：

• 给两个实体设置唯一名称，并添加鉴别列区分类型：

@Entity(name = "Book")
@Table(name = "book") // 显式指定表名
@DiscriminatorColumn(name = "entity_type") // 添加鉴别列
@DiscriminatorValue("FULL") // 给Book设置鉴别值
public class Book { ... }

@Entity(name = "BookSummary")
@Table(name = "book") // 映射到同一张表
@DiscriminatorValue("SUMMARY") // 给BookSummary设置鉴别值
public class BookSummary { ... }

这种方式需要在数据库表中添加entity_type列来区分实体类型，虽然能解决问题，但完全没必要——因为BookSummary本质就是数据传输对象，不是业务实体。

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