SpringBoot JPA多对多查询报HQL Path expected for join错误如何解决

错误原因 #

你遇到的org.hibernate.hql.internal.ast.QuerySyntaxException: Path expected for join错误核心是：@Query注解默认使用HQL（JPQL）语法，而你写的是原生SQL的表关联逻辑，不符合HQL语法规则。HQL要求实体关联必须走实体类的属性路径，不能直接手动拼接中间表的关联逻辑。

修复方案 #

方案1：改用HQL写法（推荐） #

直接利用你实体类中已经配置的多对多关联属性，JPA会自动处理中间表的关联，不需要手动写中间表JOIN逻辑，修改后的CourseRepository代码如下：

package com.cyberguard.webservice.course;

import java.util.List;

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.stereotype.Repository;

@Repository
public interface CourseRepository extends JpaRepository<Course, String> {
    // 直接关联Course实体的Majors属性即可，JPA自动映射中间表关联
    @Query("SELECT c FROM Course c JOIN c.Majors m WHERE m.ID = ?1")
    List<Course> findByMajors(Long majorId);
}

方案2：保留原生SQL写法 #

如果你坚持使用原生SQL查询，需要在@Query注解中添加nativeQuery = true标识，同时注意返回字段要匹配Course实体的映射规则，修改后的代码如下：

package com.cyberguard.webservice.course;

import java.util.List;

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.stereotype.Repository;

@Repository
public interface CourseRepository extends JpaRepository<Course, String> {
    // 添加nativeQuery = true标识为原生SQL，表名、字段名要和数据库实际配置一致
    @Query(value = "SELECT c.* FROM courses c JOIN major_courses mc ON c.Course_ID = mc.Course_ID JOIN major m ON mc.ID = m.ID WHERE m.ID = ?1", nativeQuery = true)
    List<Course> findByMajors(Long majorId);
}

可选优化建议 #

你的实体类属性命名不符合Java通用的驼峰命名规范，建议调整属性名后用@Column注解指定对应数据库字段，避免后续出现映射异常，示例如下：

@Id
@Column(name = "Course_ID")
private String courseId;

@Column(name = "Course_Name")
private String courseName;

@Column(name = "Course_Section")
private String courseSection;

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