Spring Boot JPA自定义查询抛出异常问题求助

核心问题分析 #

你遇到的问题源于：示例中Supervisor通过直接关联的外键id_keyword实现查询，但你的Professor与Stichpunkt无直接外键关联，自定义@Query时因关联关系处理错误导致查询失败。

第一步：明确实体关联关系 #

首先需确定Professor与Stichpunkt的关联模式（多对多/通过中间实体关联是最常见的场景），以下是标准关联配置示例：

多对多关联场景（最常见） #

Professor 实体类

@Entity
public class Professor {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    // 其他业务字段，如姓名、职称等

    @ManyToMany
    @JoinTable(
        name = "professor_stichpunkt", // 中间表名称
        joinColumns = @JoinColumn(name = "professor_id"), // Professor在中间表的外键
        inverseJoinColumns = @JoinColumn(name = "stichpunkt_id") // Stichpunkt在中间表的外键
    )
    private Set<Stichpunkt> stichpunkte;
    // getter、setter方法
}

Stichpunkt 实体类

@Entity
public class Stichpunkt {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String keyword; // 你要匹配的关键词字段
    // 其他业务字段

    @ManyToMany(mappedBy = "stichpunkte") // 关联关系由Professor端维护
    private Set<Professor> professors;
    // getter、setter方法
}

第二步：修正自定义@Query查询 #

根据关联关系，编写正确的JPQL查询语句：

多对多关联下的查询示例 #

@Repository
public interface ProfessorRepository extends JpaRepository<Professor, Long> {
    // 根据Stichpunkt的ID查询关联的Professor
    @Query("SELECT p FROM Professor p JOIN p.stichpunkte s WHERE s.id = :stichpunktId")
    List<Professor> findAllByStichpunktId(@Param("stichpunktId") Long stichpunktId);

    // 根据Stichpunkt的keyword字段查询关联的Professor
    @Query("SELECT p FROM Professor p JOIN p.stichpunkte s WHERE s.keyword = :keyword")
    List<Professor> findAllByStichpunktKeyword(@Param("keyword") String keyword);
}

间接关联场景（如通过Course中间实体） #

如果Professor关联Course、Course关联Stichpunkt，查询需连表到中间实体：

@Query("SELECT p FROM Professor p JOIN p.courses c JOIN c.stichpunkte s WHERE s.id = :stichpunktId")
List<Professor> findAllByStichpunktId(@Param("stichpunktId") Long stichpunktId);

第三步：常见错误排查点 #

1. 关联注解配置错误：检查@ManyToMany/@OneToMany等注解的中间表名称、外键字段是否与数据库实际结构一致；若使用spring.jpa.hibernate.ddl-auto=update，可让Hibernate自动生成/修正表结构。
2. JPQL语法错误：JPQL使用实体类名和属性名（而非数据库表名、字段名），比如Professor是类名，对应数据库表可能是professor，需严格区分。
3. 参数绑定错误：确保@Param的参数名与JPQL中:xxx的名称完全一致，或使用位置参数?1替代。
4. 数据为空/参数无效：若错误提示无匹配结果，需检查传入的stichpunktId或keyword是否在数据库中存在，以及关联表是否有对应数据。

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