带@IdClass注解的@Entity类中@PrePersist方法未被调用的原因是什么？

核心问题定位 #

你的FolderRepository泛型声明错误，导致Spring Data JPA无法正确识别实体的主键类型，进而无法判断实体是新创建状态，因此不会触发@PrePersist回调方法。

修复步骤 #

1. 修正Repository的主键泛型类型 #

将FolderRepository的泛型从JpaRepository<Folder, String>改为JpaRepository<Folder, Folder.FolderId>——你的Folder实体使用了复合主键FolderId，而非单个String类型主键：

@Repository
public interface FolderRepository extends JpaRepository<Folder, Folder.FolderId> {
}

2. （可选优化）同步实体类字段约束 #

数据库中createdAt有非空约束，建议在实体类的该字段上补充nullable=false，让JPA层面也能提前校验：

@Column(nullable = false)
private Instant createdAt;

@Column(nullable = false)
private Instant updatedAt;

3. 验证实体状态 #

确保调用saveAndFlush时传入的folderToSave是全新实体（即driveId+folderId的组合在数据库中不存在）。如果是已存在的实体，JPA会触发@PreUpdate而非@PrePersist。

原因解释 #

Spring Data JPA通过主键类型来判断实体的状态（新实体/已存在实体）：

• 当主键类型声明错误时，框架无法正确对比主键值判断实体是否为新创建，会错误地跳过@PrePersist回调。
• 修正主键泛型后，框架能正确识别实体状态，在插入新实体时触发@PrePersist方法，完成createdAt和updatedAt的赋值。

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