Spring Boot 3+JPA+H2创建Colony时JPA事务提交失败求助

核心问题定位 #

报错根源是Colony实体类中active字段的注解使用错误：@NotEmpty注解仅适用于字符串、集合、数组等类型，不能用于boolean基本类型。这个错误会触发JPA校验失败，进而导致事务无法提交。

另外，Colony的@PrePersist方法存在递归调用风险：当前代码中this.setCreatedAt(LocalDateTime.now())如果父类Audit已实现setCreatedAt方法，会导致自身调用陷入循环。

具体修复步骤 #

1. 修正Colony实体的注解与递归问题 #

将active字段上的@NotEmpty替换为@NotNull（或直接移除，因为已设置默认值true）；同时修改@PrePersist方法调用父类的setCreatedAt，避免递归：

@Data
@NoArgsConstructor
@Entity
public class Colony extends Audit{
    
    @Id
    @GeneratedValue
    @UuidGenerator
    private UUID id;

    @OneToMany(mappedBy = "colony")
    private Set<Address> addresses;

    @NotEmpty
    private String name;

    @NotNull // 替换原有的@NotEmpty
    private boolean active = true;

    @PrePersist
    public void setCreatedAt() {
        super.setCreatedAt(LocalDateTime.now()); // 调用父类方法，避免递归
    }
}

2. 规范Service层事务管理 #

在ColonyServiceImpl的createColony方法上添加@Transactional注解，明确事务边界（Spring Data JPA的save方法默认自带事务，但显式声明更清晰）：

@Component
@Transactional
public class ColonyServiceImpl implements ColonyService{
    ColonyRepository colonyRepository;

    public ColonyServiceImpl(ColonyRepository colonyRepository) {
        this.colonyRepository = colonyRepository;
    }

    @Override
    public Colony createColony(Colony colony) {
        Colony newColony = null;
        try {
            colony.setAddresses(Collections.emptySet());
            newColony = colonyRepository.save(colony);
        } catch (Exception e) {
            throw new ColonyRepositoryException("Failed to save colony with reason: " + e.getMessage());
        }
        return newColony;
    }
   
}

3. 确保请求参数合法 #

Postman请求体需符合实体校验规则，示例合法请求体：

{
    "name": "Test Colony"
}

验证修复 #

重启应用后重新调用POST /colonies接口，即可成功将Colony记录写入H2数据库。

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