Spring中如何删除多对多关联引用但不删除对应实体

核心问题排查 #

你现有代码的两个核心错误：

• 调用playerRepository.delete(player)会直接删除player实体本身，自然会同时删除关联记录和玩家数据，完全不符合仅删除中间表关联的需求
• 直接调用save未生效是典型的JPA持久化上下文、事务、关联对象状态问题

前置准备 #

首先确保你两个实体类已经正确实现了双向关联的移除逻辑，且重写了equals和hashCode方法（以主键id作为判断依据，保证List的remove方法能正确匹配到对应元素）：

// Player类中新增方法
public void removeGame(Game game) {
    this.games.remove(game);
    game.getPlayers().remove(this);
}

正确实现代码 #

推荐将业务逻辑抽至Service层，添加事务保证JPA变更能正常同步到数据库：

Service层代码 #

@Service
@Transactional // 必须加事务，JPA的变更同步依赖事务环境
public class PlayerService {
    private final PlayerRepository playerRepository;
    private final GameRepository gameRepository;

    // 构造方法注入依赖
    public PlayerService(PlayerRepository playerRepository, GameRepository gameRepository) {
        this.playerRepository = playerRepository;
        this.gameRepository = gameRepository;
    }

    public void unloveGame(Long playerId, Long gameId) {
        // 1. 查询托管态的玩家和游戏对象，不可直接使用前端传入的游离对象
        Player player = playerRepository.findById(playerId)
                .orElseThrow(() -> new IllegalArgumentException("不存在对应的玩家"));
        Game game = gameRepository.findById(gameId)
                .orElseThrow(() -> new IllegalArgumentException("不存在对应的游戏"));
        
        // 2. 移除双向关联
        player.removeGame(game);
        
        // 3. 保存关联维护方（Player持有@JoinTable是维护方，JPA以维护方的关联状态为准更新中间表）
        playerRepository.save(player);
    }
}

Controller层代码 #

不要接收完整的Game实体，仅传游戏id即可：

@DeleteMapping(path = "api/v1/player/{playerId}/unlove")
public void unloveGame(@PathVariable Long playerId, @RequestParam Long gameId) {
    playerService.unloveGame(playerId, gameId);
}

之前save操作失效的常见原因 #

1. 没有添加*@Transactional*注解，JPA的持久化上下文刷新、变更同步必须在事务环境下执行
2. 直接使用前端传入的游离态Game对象，该对象不在持久化上下文中，和数据库查询出来的托管态对象内存地址不同，导致List的remove方法匹配不到对应元素，实际没有修改关联列表
3. 仅修改了被维护方（Game类）的关联列表，JPA不会同步被维护方的变更到中间表，必须修改维护方（Player类）的关联列表

注意事项 #

多对多场景下确实不建议配置CascadeType.REMOVE，否则删除某一侧实体会级联删除另一侧的实体数据，和你的业务需求不符。

内容的提问来源于stack exchange，提问作者Isak Holmström