如何避免PostgreSQL数据库中值存在差异的重复条目？附实体存储方法

嘿，针对你提出的这个问题，结合你给出的实体定义和存储代码，我来分享几个实用的解决方案，从底层到业务层帮你彻底解决重复条目的问题：

1. 数据库层面：添加唯一约束（最可靠的底层保障） #

当前你的实体类没有针对业务唯一字段设置约束，这是导致重复条目能被存入数据库的根本原因。我们可以通过两种方式添加唯一约束：

方式一：直接在PostgreSQL中创建唯一索引 #

执行以下SQL语句，针对name和date_from的组合创建唯一约束，确保这两个字段同时相同时无法插入重复记录：

CREATE UNIQUE INDEX idx_pooldef_name_date ON pool_def (name, date_from);

方式二：通过JPA注解在实体类中定义 #

修改你的PoolDef实体类，添加@Table注解并指定唯一约束，同时调整@EqualsAndHashCode的字段（让业务层面也能识别重复）：

@Setter 
@Getter 
@EqualsAndHashCode(of = {"name", "date_from"}) // 改为对比业务唯一字段
@Transactional 
@Entity
@Table(name = "pool_def", uniqueConstraints = {
    @UniqueConstraint(columnNames = {"name", "date_from"}) // 组合唯一约束
})
public class PoolDef {
    @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long Id;
    private String name;
    @Column(name = "date_from", columnDefinition = "timestamp with time zone not null")
    private OffsetDateTime date_from;
}

注意：添加约束后，若已有重复数据，需要先清理掉才能成功创建约束哦。

2. 业务逻辑层面：保存前先检查重复 #

在调用save方法之前，先查询数据库是否已经存在相同name和date_from的记录，只有不存在时才执行保存操作，这样能在业务层提前拦截重复请求。

第一步：在Repository中添加查询方法 #

public interface PoolDefRepository extends JpaRepository<PoolDef, Long> {
    // 根据name和date_from查询是否存在记录
    Optional<PoolDef> findByNameAndDate_from(String name, OffsetDateTime date_from);
}

第二步：修改存储代码的逻辑 #

String poolName = poolList.getPoolList().get(i).getName();
OffsetDateTime targetDate = date;

// 先查询是否存在重复记录
Optional<PoolDef> existingPool = poolDefRepository.findByNameAndDate_from(poolName, targetDate);
if (existingPool.isEmpty()) {
    PoolDef poolDef = new PoolDef();
    poolDef.setDate_from(targetDate);
    poolDef.setName(poolName);
    poolDefRepository.save(poolDef);
} else {
    // 这里可以添加重复时的处理逻辑，比如日志记录、返回提示信息等
    System.out.println("记录已存在：name=" + poolName + ", date_from=" + targetDate);
}

3. 处理并发场景的补充说明 #

如果你的系统存在高并发请求，仅仅靠业务层的前置检查可能会出现“检查时不存在，同时执行保存导致重复”的情况（也就是所谓的竞态条件）。这时候数据库的唯一约束就会发挥作用，它会直接抛出SQLIntegrityConstraintViolationException异常。你可以捕获这个异常，做友好的提示处理：

try {
    poolDefRepository.save(poolDef);
} catch (SQLIntegrityConstraintViolationException e) {
    // 处理重复插入的异常
    System.err.println("尝试插入重复记录：" + e.getMessage());
    // 也可以转换为自定义异常返回给前端
}

总结 #

最稳妥的方案是数据库唯一约束 + 业务层前置检查的组合：

• 数据库约束从底层杜绝重复，不管通过什么方式操作数据库都能生效；
• 业务层检查提前拦截重复请求，避免不必要的数据库异常，提升用户体验。

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