SpringBoot中@Query无法识别多对多中间表PlayerTournament的问题

核心问题 #

你在JPQL查询中直接引用了PlayerTournament，但这个不是你定义的实体类——JPA处理多对多关联时，会自动生成一张中间关联表（默认表名通常是player_tournament，由两个实体名按规则拼接），但这张表并没有被标注为@Entity，所以JPA无法将其识别为合法的实体引用，进而抛出无法解析的错误。

正确的查询写法 #

方式一：使用JPQL通过实体关联查询（推荐） #

JPQL是面向实体对象的查询语言，你可以直接通过Tournament和Player之间的关联属性关联查询，无需手动操作中间表：

@Repository
public interface TournamentRepository extends JpaRepository<Tournament, Long> {
    @Query("SELECT t FROM Tournament t JOIN t.players p WHERE p.id = :playerId")
    List<Tournament> findByPlayerId(@Param("playerId") Long playerId);
}

这里假设你的Tournament实体中定义了关联Player的集合属性players（比如@ManyToMany(mappedBy = "tournaments") private List<Player> players;）；如果关联关系维护在Player侧，也可以从Player出发查询：

@Query("SELECT p.tournaments FROM Player p WHERE p.id = :playerId")
List<Tournament> findByPlayerId(@Param("playerId") Long playerId);

方式二：使用原生SQL查询（需指定nativeQuery=true） #

如果一定要直接操作中间表，需要使用原生SQL，并明确指定数据库中的中间表名（注意和JPA生成的表名一致，若你在@JoinTable中自定义了表名，要使用自定义名称）：

@Query(value = "SELECT t.* FROM tournament t " +
               "JOIN player_tournament pt ON t.id = pt.tournament_id " +
               "WHERE pt.player_id = :playerId", nativeQuery = true)
List<Tournament> findByPlayerId(@Param("playerId") Long playerId);

额外检查点 #

1. 确认多对多关联配置正确：比如@ManyToMany注解的mappedBy属性是否指向对方实体的关联属性，或者@JoinTable是否正确指定了中间表的名称、外键字段。
2. 避免混淆JPQL和原生SQL的语法：JPQL使用实体类名和属性名，原生SQL使用数据库表名和列名。

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