JPA Repository使用Enum参数查询关联枚举集合的Driver实体报错如何解决

• 第一个写法错误：HQL是面向实体对象的查询语言，不支持直接JOIN枚举类，且JOIN必须关联实体中已定义的属性路径，你直接关联数据库表字段driver_language_id的写法不符合HQL语法规则，因此触发「Path expected for join!」报错。
• 第二个写法错误：DriverLanguage是枚举类，没有添加@Entity注解不是JPA映射实体，HQL中不能直接将未映射的类作为查询源，因此触发「DriverLanguage is not mapped」报错。

方案1：使用@Query自定义JPQL（推荐写法） #

直接关联Driver实体中定义的languages属性做关联查询，参数直接使用枚举类型避免字符串匹配错误：

@Repository
public interface DriverRepository extends JpaRepository<Driver, Long> {
  @Query("SELECT d FROM Driver d JOIN d.languages lang WHERE lang = :language")
  List<Driver> findByLanguage(DriverLanguage language);
}

如果业务需要必须传入字符串类型的语言参数，可以直接修改参数类型，Spring Data JPA会自动将匹配的字符串转为对应枚举：

@Query("SELECT d FROM Driver d JOIN d.languages lang WHERE lang = :language")
List<Driver> findByLanguage(String language);

方案2：使用Spring Data JPA派生查询（无需手写Query） #

直接按照JPA命名规则定义方法，框架会自动生成查询语句：

@Repository
public interface DriverRepository extends JpaRepository<Driver, Long> {
  List<Driver> findByLanguages(DriverLanguage language);
}

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