Spring Data JPA结合Oracle Identity列与UUID主键的约束违反处理方案

方案1：修正实体主键映射（推荐） #

数据库表的主键是UUID列，实体类应将uuid标注为@Id，id作为Oracle Identity生成的普通列处理。这样Spring JPA会以uuid作为实体唯一标识，调用save()时自动判断：若uuid已存在则执行更新（合并），不存在则执行插入。

修改后的实体类代码：

public class Document {

    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "ID", nullable = false, updatable = false)
    private Long id;

    @Id
    @Column(name = "UUID", unique = true, nullable = false, updatable = false)
    private String uuid;

    @Column(name = "DOC_TYPE", nullable = false)
    private String docType;

    @Column(name = "DESCRIPTION", nullable = false)
    private String description;

    // 构造方法、getter/setter省略
}

处理后，传入uuid为sadwe-1232-123的瞬时实体时，Spring JPA会自动查询对应实体，合并新属性后更新，不会触发主键约束冲突。

方案2：自定义Repository的save逻辑（兼容原有实体结构） #

若无法修改现有实体的@Id标注，可在Repository层封装自定义的saveOrMerge方法，利用Spring Data的查询能力先判断实体是否存在，再执行对应操作：

1. 定义Repository接口：

public interface DocumentRepository extends JpaRepository<Document, Long> {
    Optional<Document> findByUuid(String uuid);

    default Document saveOrMerge(Document transientDoc) {
        return findByUuid(transientDoc.getUuid())
                .map(existingDoc -> {
                    // 按需合并需要更新的属性
                    existingDoc.setDocType(transientDoc.getDocType());
                    existingDoc.setDescription(transientDoc.getDescription());
                    return save(existingDoc);
                })
                .orElseGet(() -> save(transientDoc));
    }
}

2. 调用时替换原生save()：

documentRepository.saveOrMerge(transientDocument);

这种方式用Lambda表达式完成合并逻辑，比手动映射更简洁。

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