Springboot + Hibernate:保存实体时出现重复条目异常

在使用Spring Boot和Hibernate进行开发时，遇到保存实体时出现重复条目异常（通常是org.hibernate.NonUniqueObjectException或org.hibernate.StaleObjectStateException），通常是由于以下几个原因造成的：

基础概念

实体管理：Hibernate通过Session来管理实体的生命周期，包括实体的持久化、更新和删除。
一级缓存：Hibernate的Session内部维护了一个一级缓存（也称为事务级缓存），同一个Session中加载的实体会被缓存起来。
唯一性约束：数据库表中的某些字段可能设置了唯一性约束（如唯一索引或主键），确保这些字段的值不会重复。

可能的原因

重复提交：同一个实体被多次保存到数据库中。
并发问题：多个事务同时修改同一个实体，导致数据不一致。
一级缓存问题：同一个Session中加载了相同的实体，再次保存时会抛出异常。

解决方案

1. 检查重复提交

确保在业务逻辑中不会重复提交同一个实体。可以通过加锁或使用唯一标识符来避免重复提交。

@Transactional
public void saveEntity(Entity entity) {
    if (entityRepository.existsById(entity.getId())) {
        throw new RuntimeException("Entity already exists");
    }
    entityRepository.save(entity);
}

2. 处理并发问题

使用乐观锁或悲观锁来处理并发问题。

乐观锁：通过版本号来实现。

@Entity
public class Entity {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Version
    private Integer version;

    // other fields and methods
}

悲观锁：在查询时使用LockModeType.PESSIMISTIC_WRITE。

@Transactional
public void saveEntity(Entity entity) {
    Entity existingEntity = entityRepository.findById(entity.getId(), LockModeType.PESSIMISTIC_WRITE);
    if (existingEntity != null) {
        throw new RuntimeException("Entity already exists");
    }
    entityRepository.save(entity);
}

3. 清理一级缓存

在某些情况下，可能需要手动清理Session的一级缓存。

@Transactional
public void saveEntity(Entity entity) {
    Session session = entityManager.unwrap(Session.class);
    session.evict(entity); // 清理缓存
    entityRepository.save(entity);
}

应用场景

高并发系统：在需要处理大量并发请求的场景中，合理使用锁机制可以有效避免数据不一致问题。
数据一致性要求高的系统：如金融系统、订单系统等，确保数据的唯一性和一致性至关重要。

示例代码

以下是一个完整的示例，展示了如何使用乐观锁来避免重复条目异常：

@Entity
public class Entity {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Version
    private Integer version;

    // other fields and methods
}

@Repository
public interface EntityRepository extends JpaRepository<Entity, Long> {
}

@Service
public class EntityService {

    @Autowired
    private EntityRepository entityRepository;

    @Transactional
    public void saveEntity(Entity entity) {
        if (entityRepository.existsById(entity.getId())) {
            throw new RuntimeException("Entity already exists");
        }
        entityRepository.save(entity);
    }
}

通过以上方法，可以有效解决Spring Boot和Hibernate在保存实体时出现的重复条目异常问题。