如何让Spring Data JPA/Hibernate在唯一索引冲突时替换行？

针对你的需求，有两种简便的方案，无需手动维护冗长的UPSERT语句，也不用捕获异常后删行重试：

方案一：利用PostgreSQL 12+的SET * = EXCLUDED结合Hibernate自定义插入SQL #

通过Hibernate的@SQLInsert注解覆盖实体默认的插入逻辑，让JPA调用save()方法时自动执行UPSERT，冲突时全量替换现有行。

实现步骤： #

1. 确保你的PostgreSQL版本在12及以上（该版本支持SET * = EXCLUDED语法，无需枚举所有字段）
2. 在你的@Entity类上添加@SQLInsert注解，自定义插入语句：

@Entity
@Table(name = "your_entity_table")
@SQLInsert(
    sql = "INSERT INTO your_entity_table (field1, field2, field3, your_unique_key_field) " +
          "VALUES (?, ?, ?, ?) " +
          "ON CONFLICT (your_unique_key_field) DO UPDATE SET * = EXCLUDED"
)
public class YourEntity {
    // 主键字段
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    // 唯一键字段
    @Column(unique = true, nullable = false)
    private String yourUniqueKeyField;
    
    // 其他实体字段
    private String field1;
    private Integer field2;
    private Date field3;
    // ... 更多字段
    
    // getter/setter 略
}

• 占位符?的顺序要和Hibernate默认生成的INSERT语句字段顺序一致（可通过开启Hibernate SQL日志确认）
• EXCLUDED代表原本要插入的新行，SET * = EXCLUDED会用新行的所有字段覆盖现有行，无需手动枚举列

之后调用JPA的repository.save(yourEntity)时：

• 如果唯一键不存在，执行正常插入
• 如果唯一键冲突，自动全量替换现有行

方案二：Spring Data JPA自定义Repository方法（支持单条/批量操作） #

如果不想修改实体注解，可以在Repository中定义原生SQL方法，同样利用PostgreSQL的EXCLUDED语法实现全量替换：

单条数据操作： #

@Repository
public interface YourEntityRepository extends JpaRepository<YourEntity, Long> {

    @Modifying
    @Transactional
    @Query(
        value = "INSERT INTO your_entity_table " +
                "SELECT * FROM unnest(:entity::your_entity_table[]) " +
                "ON CONFLICT (your_unique_key_field) DO UPDATE SET * = EXCLUDED",
        nativeQuery = true
    )
    void upsertFullReplace(@Param("entity") YourEntity entity);
}

批量数据操作： #

@Modifying
@Transactional
@Query(
    value = "INSERT INTO your_entity_table " +
            "SELECT * FROM unnest(:entities::your_entity_table[]) " +
            "ON CONFLICT (your_unique_key_field) DO UPDATE SET * = EXCLUDED",
    nativeQuery = true
)
void bulkUpsertFullReplace(@Param("entities") List<YourEntity> entities);

• 利用PostgreSQL的数组类型和unnest函数，将实体对象转为数据库可识别的行数据
• 无需枚举字段，后续实体新增字段时SQL无需修改

注意事项 #

• 两种方案都依赖PostgreSQL的ON CONFLICT语法，必须确保表上存在对应的唯一约束（即你遇到的some_unique_key）
• 方案一的@SQLInsert会覆盖JPA默认的插入逻辑，如果你需要区分插入和更新场景，需谨慎使用
• 若使用PostgreSQL 12以下版本，无法使用SET * = EXCLUDED，需改为枚举所有字段（如SET (field1, field2) = (EXCLUDED.field1, EXCLUDED.field2)），但这种方式需要维护字段列表，不符合你的需求，建议升级数据库版本

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