如何在@ElementCollection中允许重复元素？CrudRepository玩家卡牌存储报错解决

嘿，这个问题我之前也碰到过！问题出在JPA对@ElementCollection的默认处理上——当你用Collection作为字段类型时，Hibernate（以及其他JPA实现）默认会把它映射成Set，而Set是不允许重复元素的，这就是你插入重复卡牌时报错的原因。

要实现存储重复卡牌的需求，只需对Player类做两处关键修改：

修改后的Player类代码 #

public class Player {
    @Id
    String playerId;
    
    @ElementCollection(targetClass = Card.class)
    @LazyCollection(LazyCollectionOption.FALSE)
    // 1. 将Collection改为List，明确需要允许重复的有序集合
    // 2. 添加@OrderColumn定义顺序列，让JPA维护元素的存储顺序
    @OrderColumn(name = "card_position")
    List<Card> cards = new ArrayList<>();

    // 建议添加getter/setter，确保JPA能正常访问字段
    public String getPlayerId() {
        return playerId;
    }

    public void setPlayerId(String playerId) {
        this.playerId = playerId;
    }

    public List<Card> getCards() {
        return cards;
    }

    public void setCards(List<Card> cards) {
        this.cards = cards;
    }
}

关键修改说明 #

• 改用List<Card>类型：明确告诉JPA我们需要一个允许重复元素的集合，List的特性就是支持重复元素的存储。
• 添加@OrderColumn注解：这个注解会在自动生成的关联表中新增一个整数列（比如示例中的card_position），用来记录每个卡牌在列表中的位置。JPA通过这个列来维护元素的顺序，同时允许同一枚举值重复出现。
• 确保字段可访问：JPA需要能够读取和写入cards字段，所以要么把字段设为public，要么添加对应的getter/setter方法（示例中已经添加），也可以用@Access(AccessType.FIELD)注解指定直接访问字段。

数据库表变化 #

JPA会为@ElementCollection自动创建关联表（默认名称是player_cards，格式为主表名_字段名），添加@OrderColumn后，这个表会多出一个card_position列，用来存储每个元素的顺序索引，这样重复的Card枚举值就能被正常存储了。

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