如何将含动态日期键的JSON映射为JPA实体类

针对你遇到的两个错误，这里提供两种可行的映射方案，优先推荐第一种无需额外实体的实现方式：

方案一：直接用@ElementCollection映射Map（最优解） #

不需要单独创建TimePlayed实体，通过JPA的集合映射注解直接处理Map<Date, Integer>类型的字段，既简洁又能解决报错问题。修改后的GameData类如下：

@Table(name = "GAME_DATA")
@Entity
@Data
public class GameData {

    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private String gameDataId;

    private String publisherId;
    private String name;

    // 核心映射配置
    @ElementCollection
    @CollectionTable(
        name = "GAME_TIME_PLAYED", 
        joinColumns = @JoinColumn(name = "game_data_id") // 关联GameData的主键
    )
    @MapKeyTemporal(TemporalType.DATE) // 指定Map的键是日期类型
    @MapKeyColumn(name = "play_date") // 数据库中存储日期的列名
    @Column(name = "play_time_minutes") // 数据库中存储游玩时长的列名
    private Map<Date, Integer> timePlayed;
}

配置说明： #

• @ElementCollection：告诉JPA这是一个非实体类型的集合字段，会自动生成关联表存储Map数据
• @CollectionTable：指定存储Map数据的表名，以及关联主表的外键字段
• @MapKeyTemporal：明确Map的键是日期类型，避免JPA无法识别字段类型
• 这种方式不会触发'Basic' attribute type should not be a map错误，因为JPA不再把Map当作基础类型处理

方案二：使用关联实体（适合复杂业务场景） #

如果确实需要单独的TimePlayed实体，需修正关联映射逻辑，解决 transient 实例未保存的问题：

1. 修改TimePlayed实体 #

把原来的Map拆分为单独的日期和时长字段，并关联到GameData：

@Table(name = "TIME_PLAYED")
@Entity
@Data
public class TimePlayed {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE)
    @Column(name = "id", nullable = false)
    private Long id;

    // 关联GameData主实体
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "game_data_id")
    private GameData gameData;

    @Temporal(TemporalType.DATE)
    private Date playDate; // 单独存储日期

    private Integer playTime; // 单独存储游玩时长
}

2. 修改GameData中的关联配置 #

添加级联保存配置，确保保存GameData时自动保存关联的TimePlayed实例：

@Table(name = "GAME_DATA")
@Entity
@Data
public class GameData {

    // 原有字段不变...

    // 用Map关联TimePlayed实体，键为playDate
    @OneToMany(mappedBy = "gameData", cascade = CascadeType.ALL, orphanRemoval = true)
    @MapKey(name = "playDate")
    private Map<Date, TimePlayed> timePlayed;
}

错误原因说明： #

• Object references an unsaved transient instance：之前未配置cascade = CascadeType.ALL，导致保存GameData时，关联的TimePlayed实例处于未保存的 transient 状态，JPA要求先保存关联实例再保存主实体
• 'Basic' attribute type should not be a map：直接将Map作为实体字段时，JPA默认视为基础类型，但基础类型不允许是集合/Map类型，必须通过@ElementCollection或关联映射声明处理方式

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