Spring Boot中带额外字段多对多关联表的CRUD操作实现咨询

1. POST请求归属问题 #

针对「新增单词并分配到指定Deck」的场景，更推荐两种方案，按业务语义选即可：

• 优先放在DeckWord对应的Controller下，或者设计为Deck下的子资源接口，路径用POST /decks/{deckId}/words，语义更清晰：该接口的核心逻辑是给指定Deck绑定单词，而不是单纯新增单词本体。
• 只有纯新增不绑定任何Deck的单词场景，才走Word对应的Controller，避免接口职责混乱。

2. 是否需要同步Deck的List<DeckWord>属性 #

你当前代码中Deck的@OneToMany配置了mappedBy = "deck"，属于关联关系的被动维护方，不需要强制同步：

• 如果保存DeckWord后，当前事务内不需要用到Deck的deckwords列表，完全不用手动更新，下次查询时JPA会自动拉取数据库最新的关联数据。
• 如果同一个持久化上下文（Session）内，保存完DeckWord后还需要操作Deck的deckwords列表，才需要手动把新建的DeckWord加入列表，避免缓存和数据库数据不一致。

实操代码示例 #

@Service
public class DeckWordService {
    // 以下Repository注入省略构造方法
    private final WordRepository wordRepository;
    private final DeckRepository deckRepository;
    private final DeckWordRepository deckWordRepository;

    @Transactional
    public DeckWord addNewWordToDeck(Long deckId, WordAddReq req) {
        // 1. 先保存新增的单词本体
        Word newWord = new Word();
        newWord.setDefinition(req.getDefinition());
        newWord.setTranscription(req.getTranscription());
        newWord = wordRepository.save(newWord);

        // 2. 查询目标Deck
        Deck targetDeck = deckRepository.findById(deckId)
                .orElseThrow(() -> new IllegalArgumentException("指定Deck不存在"));

        // 3. 构造中间表实体
        DeckWord newRelation = new DeckWord();
        DeckWordKey key = new DeckWordKey();
        key.setDeckId(deckId);
        key.setWordId(newWord.getId());
        newRelation.setId(key);
        newRelation.setDeck(targetDeck);
        newRelation.setWord(newWord);
        // 初始化中间表额外字段
        newRelation.setLearnt(false);
        newRelation.setLastChecked(null);
        newRelation.setWordGroup(req.getWordGroup());

        // 4. 保存中间表即可完成关联
        DeckWord savedRelation = deckWordRepository.save(newRelation);

        // 【可选：同事务内需要用targetDeck的deckwords列表时才打开注释】
        // targetDeck.getDeckwords().add(savedRelation);

        return savedRelation;
    }
}

额外注意点 #

• 你当前Deck和Word的@OneToMany都配置了cascade = CascadeType.ALL，如果你的业务允许多个Deck共享同一个单词，建议移除REMOVE级联，避免删除关联关系时误删单词本体。
• 如果后续需要给已有单词绑定Deck，直接调用POST /deck-words接口传deckId、wordId和中间表额外字段即可，不需要操作Word和Deck的实体属性。

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