JPA Hibernate多对多关联查询报错及返回空集合问题求解

• 第一个语法错误：JPQL中关联查询必须指定实体类中定义的关联属性，你直接写join Shop u没有绑定Shoe实体上的多对多关联字段，Hibernate无法生成正确的中间表关联逻辑，最终生成的SQL缺失关联条件，触发where附近语法错误。
• 第二个返回空集合问题：s.vendeur.idShop写法错误，vendeur是@ManyToMany对应的集合类型属性，JPQL不支持直接访问集合元素的属性，该写法会生成不符合预期的查询条件，无法匹配到中间表的关联数据，因此返回空集合。

第一步：确认双向多对多映射配置正确 #

确保你的实体类关联配置符合规范，示例如下：

// Shoe 实体类
@Entity
public class Shoe {
    @Id
    private Long id;
    // 对应多对多关联，配置中间表
    @ManyToMany
    @JoinTable(
        name = "Shoes_Asked_By_Shops_Associations",
        joinColumns = @JoinColumn(name = "shoe_id"), // 对应Shoe表的主键关联字段
        inverseJoinColumns = @JoinColumn(name = "shop_id") // 对应Shop表的主键关联字段
    )
    private List<Shop> vendeur; // 属性名和你代码中保持一致
    // 其他属性、getter/setter省略
}

// Shop 实体类
@Entity
public class Shop {
    @Id
    private Long idShop; // 主键属性名和你查询中用到的保持一致
    // 双向关联的反向端，mappedBy值为Shoe类中关联属性的名称
    @ManyToMany(mappedBy = "vendeur")
    private List<Shoe> shoes;
    // 其他属性、getter/setter省略
}

第二步：修改为正确的JPQL查询语句 #

两种可用写法二选一即可：

写法1：关联属性join查询 #

@Query("select distinct s from Shoe s join s.vendeur u where u.idShop = :idShop")
List<Shoe> findAllByShop(@Param("idShop") Long idShop);

加distinct是为了避免一个鞋关联多个店铺时返回重复数据。

写法2：member of 语法 #

如果入参是Shop实体，可使用更简洁的写法：

@Query("select s from Shoe s where :shop member of s.vendeur")
List<Shoe> findAllByShop(@Param("shop") Shop shop);

第三步：排查其他可能问题 #

• 确认Repository方法的@Param注解参数名和JPQL中占位符名称完全一致，避免参数绑定错误。
• 开启Hibernate SQL打印配置，将生成的原生SQL放到数据库中执行，确认是否能查询到数据，如果SQL执行无结果，检查传入的idShop值是否正确，是否存在中间表关联数据。
• 确认Vaadin视图层调用Repository方法时传入的参数值不为空，且为数据库中存在的Shop主键值。

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