Spring多表插入时CascadeType.ALL引发唯一键重复问题求助

问题背景 #

开发Spring应用时，Controller的POST方法支持批量创建关联主实体EncodingResult的多个实体。测试时先遇到"object references an unsaved transient instance"错误，为解决该问题，在主类带@JoinColumn注解的属性上添加了CascadeType.ALL：

@ManyToOne(fetch = FetchType.LAZY, cascade = CascadeType.ALL)
@JoinColumn(name = "codec", referencedColumnName = "commit_hash", nullable = false)
private Codec codec;

Codec实体的相关配置：

@OneToMany(cascade = CascadeType.ALL, mappedBy = "codec")
private Set<EncodingResult> associatedResults = new HashSet<>();

@Column(name = "commit_hash", nullable = false, unique = true)
// indicates the precise version of the codec
private String commitHash;

但修改后又引发新错误：

PSQLException: ERROR: duplicate key value violates unique constraint "uk_paitxovhx3j95tuaq9krkk9qh" Detail: Key (commit_hash)=(ec44ee022959410f9596175b9424d9fe1ece9bc8) already exists.

请求JSON示例：

{
    "codec": {
        "name": "vvcodec",
        "commitHash": "ec44ee022959410f9596175b9424d9fe1ece9bc8",
        "codecAttrs": "--threads 1",
        "preset": ""
    },
    "video": {
        "name": "bowing_cif",
        "resolution": "352x288",
        "fps": 29.97,
        "nFrames": 300,
        "format": "y4m",
        "uniqueAttrs": "fps29.97_nf300_fy4m_r352x288_nbowing_cif"
    },
    "encodingConfig": {
        "uniqueAttrs": "qp27_nf30_nt8_ca",
        "qp": 27,
        "nFrames": 30,
        "nThreads": 8,
        "codecAttrs": ""
    },
    "ypsnr": 48.2012,
    "upsnr": 49.5337,
    "vpsnr": 51.1360,
    "yuvpsnr": 48.749,
    "bitrate": 196.1958,
    "time": 0.595,
    "energyConsumption": 78.32 
}

Service层原代码：

public EncodingResult saveEncodingResult(EncodingResult encodingResult) {
        var video = encodingResult.getVideo();
        var encodingConfig = encodingResult.getEncodingConfig();
        var codec = encodingResult.getCodec();

        if (videoRepository.findByUniqueAttrs(video.getUniqueAttrs()).isEmpty())
            videoRepository.save(video);
        if (encodingConfigRepository.findByUniqueAttrs(encodingConfig.getUniqueAttrs()).isEmpty())
            encodingConfigRepository.save(encodingConfig);
        if (codecRepository.findByCommitHash(codec.getCommitHash()).isEmpty())
            codecRepository.save(codec);

        return encodingResultRepository.save(encodingResult);
    }

问题原因 #

1. CascadeType.ALL包含PERSIST操作，当调用encodingResultRepository.save时，Hibernate会自动级联持久化关联的codec对象。
2. 虽然Service层手动检查并保存了不存在的codec，但没有将持久化后的codec实例赋值回encodingResult，此时encodingResult中的codec仍然是传入的临时（未持久化）对象。
3. Hibernate识别到这个临时对象，会再次执行insert操作，导致数据库中commit_hash唯一键冲突。

解决方案 #

1. 移除不必要的级联配置 #

因为关联实体的持久化已经在Service层手动处理，不需要在@ManyToOne上添加CascadeType.ALL，直接移除即可：

@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "codec", referencedColumnName = "commit_hash", nullable = false)
private Codec codec;

2. 关联持久化实例到主实体 #

在Service层，查询或保存关联实体后，将持久化后的实例赋值回EncodingResult，确保主实体关联的是已处于持久化状态的对象：

public EncodingResult saveEncodingResult(EncodingResult encodingResult) {
    // 处理Video关联
    Video video = encodingResult.getVideo();
    Video persistedVideo = videoRepository.findByUniqueAttrs(video.getUniqueAttrs())
            .orElseGet(() -> videoRepository.save(video));
    encodingResult.setVideo(persistedVideo);

    // 处理EncodingConfig关联
    EncodingConfig encodingConfig = encodingResult.getEncodingConfig();
    EncodingConfig persistedConfig = encodingConfigRepository.findByUniqueAttrs(encodingConfig.getUniqueAttrs())
            .orElseGet(() -> encodingConfigRepository.save(encodingConfig));
    encodingResult.setEncodingConfig(persistedConfig);

    // 处理Codec关联
    Codec codec = encodingResult.getCodec();
    Codec persistedCodec = codecRepository.findByCommitHash(codec.getCommitHash())
            .orElseGet(() -> codecRepository.save(codec));
    encodingResult.setCodec(persistedCodec);

    return encodingResultRepository.save(encodingResult);
}

3. 批量创建优化（可选） #

如果是批量创建多个EncodingResult，可以先收集所有关联实体的唯一标识（如commitHash、uniqueAttrs），一次性查询数据库，批量保存不存在的实体，再将持久化实例关联到对应的EncodingResult，减少数据库查询次数，提升性能。

验证效果 #

修改后，批量创建操作将不会再出现transient instance错误，同时避免了唯一键冲突——每个关联实体只会被插入一次，主实体关联的都是已持久化的实例，Hibernate能正确处理关联关系。

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