JPA持久化Embeddable类中Map失败，数据库表为空求助

问题描述 #

我有三个关联类：Job、Task与DockerEnvironment（Embeddable类），其中DockerEnvironment包含带@ElementCollection注解的Map类型environmentVars。发送REST请求创建Job时传入包含environmentVars的JSON数据，代码中手动调用saveTask、saveJob并flush后，调试显示数据正常，但数据库DOCKER_ENV_VARS_MAPPING表为空，求排查问题原因。

相关代码 #

Job类 #

@AllArgsConstructor
@NoArgsConstructor
@ToString(callSuper = true)
@Getter
@Setter
@Entity
public class Job implements Serializable {

    @Id
    @Column(name = "JOB_ID")
    private String jobId;

    @OneToMany(fetch = FetchType.EAGER, orphanRemoval = true, cascade = CascadeType.REFRESH)
    private List<Task> tasks;

}

Task类 #

@NoArgsConstructor
@ToString(callSuper = true)
@Getter
@Setter
@Entity
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "taskId", scope = Task.class)
public class Task implements Serializable {

    @Id
    @Column(name = "TASK_ID")
    private String taskId;

    @Embedded
    private DockerEnvironment environment;

}

DockerEnvironment类 #

@AllArgsConstructor
@NoArgsConstructor
@ToString(callSuper = true)
@Getter
@Setter
@Embeddable
@JsonTypeName(value = "docker")
public class DockerEnvironment extends AbstractInstallation {

    @Column(name = "DOCKER_IMAGE")
    private String dockerImage;

    @Column(name = "PORT")
    @JsonProperty("port")
    private String port;

    @ElementCollection
    @CollectionTable(name = "DOCKER_ENV_VARS_MAPPING", joinColumns = { @JoinColumn(name = "DOCKER_TASK_ID") })
    @MapKeyColumn(name = "ENVVAR_KEY")
    @Column(name = "ENVVAR_VALUE")
    private Map<String, String> environmentVars;

}

REST请求JSON片段 #

...
"tasks": [{
    "installation": {
        "environmentVars": {
            "MYSQL_DATABASE": "NAME",
            "MYSQL_USER": "USER",
            "MYSQL_ROOT_PASSWORD": "admin"
            }
...

保存代码 #

repositoryService.saveTask(newTask);
repositoryService.saveJob(newJob);
repositoryService.flush();

排查原因与解决方案 #

1. 级联操作配置不足 #

Job类的@OneToMany仅配置了CascadeType.REFRESH，该类型仅会将刷新操作级联到关联的Task实例，保存、更新操作不会触发级联。即使手动调用saveTask，DockerEnvironment作为嵌入式对象，其ElementCollection的持久化依赖于Task的持久化上下文状态，若级联配置缺失，子集合的变更无法被JPA跟踪并持久化。

解决方案：修改Job类的@OneToMany注解，添加必要的级联类型，推荐使用CascadeType.ALL或至少包含PERSIST和MERGE：

@OneToMany(fetch = FetchType.EAGER, orphanRemoval = true, cascade = {CascadeType.REFRESH, CascadeType.PERSIST, CascadeType.MERGE})
private List<Task> tasks;

2. JSON字段与实体属性映射不匹配 #

REST请求JSON中使用的字段是installation，但Task类中对应的属性是environment，Jackson默认无法自动完成跨名称的映射，导致DockerEnvironment对象未被正确反序列化，内存中的environmentVars实际为空，自然不会写入数据库。

解决方案：在Task类的environment属性上添加@JsonProperty注解，指定JSON字段名：

@Embedded
@JsonProperty("installation")
private DockerEnvironment environment;

3. 保存顺序与关联关系维护问题 #

若newJob的tasks列表未正确添加newTask实例，或者保存顺序导致持久化上下文无法跟踪完整的关联链，即使调试时内存对象显示正常，JPA也不会将environmentVars的变更同步到数据库。此外，手动分开保存Task和Job可能破坏JPA的上下文跟踪逻辑。

解决方案：

• 确保newJob.getTasks()已包含newTask实例，维护好对象间的关联关系；
• 利用级联操作简化保存流程，只需保存Job即可自动持久化关联的Task及其嵌入式对象：

  repositoryService.saveJob(newJob);
  repositoryService.flush();
  

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