JPA/Hibernate保存父实体时首个Book子实体未持久化问题

问题根源 #

1. 双向关联未维护：因为Item的@OneToMany配置了mappedBy = "item"，所以Book是关联关系的维护端，必须手动给Book设置item属性。光把Book加到Item的集合里没用，Hibernate没法自动把外键item_id写到数据库里，哪怕开了级联也不行。
2. Book没重写equals和hashCode：用Set存关联实体时，Hibernate靠这俩方法识别元素唯一性。没重写的话，持久化时可能把第一个Book当成重复元素处理，导致丢失。
3. 集合类型不匹配：Item里定义books是LinkedHashSet，但测试用例用了HashSet，集合类型不一致可能触发异常处理逻辑。

具体修复步骤 #

1. 手动维护双向关联 #

不管是新增还是更新，把Book加到Item集合的同时，一定要给Book设置对应的Item对象：

// 测试用例里修改Book创建逻辑
Book book1 = new Book();
book1.setTitle("Book 1");
book1.setItem(inputItem); // 关键：设置反向关联

Book book2 = new Book();
book2.setTitle("Book 2");
book2.setItem(inputItem); // 同样设置反向关联

// 改用LinkedHashSet，和Item里的定义保持一致
Set<Book> books = new LinkedHashSet<>();
books.add(book1);
books.add(book2);

2. 给Book重写equals和hashCode #

基于业务唯一字段来实现（比如title，注意不要用自增的id，因为新建实体时id是null）：

@Entity
public class Book {
    // 原有属性...

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        Book book = (Book) o;
        return Objects.equals(title, book.title);
    }

    @Override
    public int hashCode() {
        return Objects.hash(title);
    }
}

如果title不是唯一的，换成业务上唯一的字段组合就行。

3. 统一集合类型 #

所有用到books集合的地方都用LinkedHashSet，避免集合转换带来的问题。

4. 补全updateItem的books处理逻辑 #

你的updateItem方法只处理了subItems，如果需要更新books，得加上对应的逻辑，同时也要维护双向关联：

public Item updateItem(Item inputItem) {
    Item existingItem = itemRepository.findById(inputItem.getId())
        .orElseThrow(() -> new RuntimeException("Item not found"));

    // 原有subItems处理逻辑...

    // 添加books处理逻辑
    Set<Book> updatedBooks = inputItem.getBooks().stream().map(book -> {
        Book newBook = new Book();
        newBook.setTitle(book.getTitle());
        if (book.getId() != null) {
            newBook.setId(book.getId());
        }
        newBook.setItem(existingItem); // 维护反向关联
        return newBook;
    }).collect(Collectors.toCollection(LinkedHashSet::new));
    existingItem.setBooks(updatedBooks);

    return itemRepository.save(existingItem);
}

验证 #

重新跑测试用例，现在两个Book都会被正确存到数据库里，books表的item_id也会正确赋值，测试断言能通过。

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