JPA使用saveAll避免重复条目及定时更新时的报错解决

问题根源 #

你遇到的HibernateException是因为使用INSERT IGNORE后，当数据库检测到重复的countryCode时不会执行插入操作，也就不会生成自增ID，但Hibernate的saveAll方法默认期望数据库返回新生成的ID来更新实体对象，两者冲突导致报错。即使移除@SQLInsert或取消唯一约束，只要重复插入的场景存在，逻辑上依然会触发类似问题。

可行解决方案 #

方案1：用INSERT ... ON DUPLICATE KEY UPDATE替代INSERT IGNORE #

这种方式既避免重复插入，又能让数据库返回合法的受影响行数，满足Hibernate的ID校验逻辑。你需要保留countryCode的唯一约束（这是判断重复的核心），修改实体类的@SQLInsert注解：

@Entity
@EntityListeners(AuditingEntityListener::class)
@SQLInsert(sql="INSERT INTO countries(country_code) VALUES(?) ON DUPLICATE KEY UPDATE country_code = VALUES(country_code)")
@Table(name = "countries")
class Country (
        @Column(unique=true)
        var countryCode: String? = null,
){
        @Id
        @GeneratedValue(strategy = GenerationType.IDENTITY)
        var id: Long = 0
}

注：country_code = VALUES(country_code)是无意义的占位更新，目的是让数据库返回受影响行数；如果有需要更新的字段（比如最后更新时间），可以替换成对应字段的更新逻辑。

方案2：先查询过滤再插入 #

在调用saveAll前，先查询数据库中已存在的countryCode，过滤掉重复数据后再执行保存，从根源避免重复插入场景：

fun batchSaveCountries(newCountries: List<Country>) {
    // 查询数据库中已有的国家编码
    val existingCodes = countryRepository.findAllByCountryCodeIn(newCountries.mapNotNull { it.countryCode })
        .map { it.countryCode }
        .toSet()
    // 过滤出仅需新增的国家数据
    val countriesToSave = newCountries.filter { !existingCodes.contains(it.countryCode) }
    countryRepository.saveAll(countriesToSave)
}

这种方式逻辑直观，无需修改数据库层面的SQL语句，适合业务逻辑简单的场景。

关键注意事项 #

• 必须保留countryCode的unique=true约束，这是判断数据重复的基础，取消约束会导致重复数据无法被检测。
• 方案1依赖唯一约束才能触发ON DUPLICATE KEY UPDATE逻辑，否则该语句与普通INSERT无区别。

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