JPA自定义查询参数绑定报错：如何实现单用户项目列表查询？

1. 命名参数绑定错误：@Query中使用的参数占位符:id_user与方法参数Long id名称不匹配，Spring Data JPA无法将参数值绑定到查询语句中。
2. 查询逻辑错误：原查询SELECT p FROM Project p WHERE p.id = :id_user是用项目ID匹配用户ID，完全不符合“查询用户所有项目”的需求，正确条件应该是匹配项目关联的用户ID。

方案1：修正自定义@Query查询 #

步骤1：修正ProjectRepository的查询语句 #

确保参数占位符与方法参数名称一致，同时修正查询条件：

@Query("SELECT p FROM Project p WHERE p.user.id = :userId")
List<Project> findProjectByUser(@Param("userId") Long userId);

注：如果Spring Data JPA版本在2.0及以上，当参数名称和占位符名称完全一致时，可以省略@Param注解，简化为：

@Query("SELECT p FROM Project p WHERE p.user.id = :userId")
List<Project> findProjectByUser(Long userId);

如果你的Project类中直接映射了id_user字段（而非关联User对象），可以直接查询该字段：

@Query("SELECT p FROM Project p WHERE p.id_user = :userId")
List<Project> findProjectByUser(Long userId);

步骤2：确保Project类映射正确 #

Project类中需要正确配置与用户的关联关系，示例如下：

@Entity
public class Project {
    // 其他字段及主键配置
    @ManyToOne
    @JoinColumn(name = "id_user")
    private User user;
    
    // 或仅存储用户ID（无需关联User对象时）：
    // @Column(name = "id_user")
    // private Long userId;
    
    // getter、setter方法
}

方案2：使用Spring Data JPA派生查询 #

无需编写自定义@Query，直接通过方法名让框架自动生成查询语句，更简洁高效：

public interface ProjectRepository extends JpaRepository<Project, Long> {
    // 当Project类中存储的是userId字段时
    List<Project> findByUserId(Long userId);
    
    // 当Project类中关联的是User对象时
    // List<Project> findByUser_Id(Long userId);
}

框架会根据方法名自动解析生成对应查询语句，无需手动编写JPQL。

验证其他层代码 #

Controller和Service层代码无需修改，保持现有逻辑即可：

• ProjectController：

@GetMapping("/listar/{userId}")
public ResponseEntity<List<Project>> listProjectsByUser(@PathVariable Long userId) {
    return ResponseEntity.ok(projectService.listProjectsByUser(userId));
}

• ProjectService：

public List<Project> listProjectsByUser(Long userId) {
    // 注意此处方法名需与Repository中定义的一致
    return projectRepository.findProjectByUser(userId);
}

内容的提问来源于stack exchange，提问作者Murillo N.S