嘿，这个问题我太熟了！不少开发者刚用Spring Data JPA写自定义查询时都会踩这个坑，本质就是查询语句里的参数和方法参数没对应上，咱们来一步步搞定它。

常见错误原因 & 解决方法 #

1. 位置参数顺序不匹配 #

如果你用的是?1、?2这种位置占位符，必须保证查询里的位置序号和方法参数的顺序完全一致。比如下面这个错误写法：

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    // 查询里?1对应email，但方法第一个参数是status，顺序完全反了！
    @Query("select u from User u where u.email = ?1 and u.status = ?2")
    List<User> findByEmailAndStatus(String status, String email);
}

这时候Spring Data JPA会找不到位置1对应的参数（因为第一个参数是status，但查询里?1要的是email），直接抛出你遇到的异常。

解决方法：要么调整方法参数顺序，让它和查询里的位置序号对应：

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    @Query("select u from User u where u.email = ?1 and u.status = ?2")
    List<User> findByEmailAndStatus(String email, String status); // 顺序匹配了
}

2. 没使用@Param注解绑定命名参数 #

比位置参数更稳妥的是用命名参数，但必须在方法参数上用@Param注解明确绑定查询里的占位符名称，否则Spring Data JPA找不到对应关系。比如错误写法：

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    // 用了:email命名参数，但方法参数没加@Param
    @Query("select u from User u where u.email = :email and u.status = :status")
    List<User> findByEmailAndStatus(String email, String status);
}

这种情况也会抛出参数不存在的异常，因为框架不知道哪个参数对应:email。

解决方法：给每个方法参数加上@Param，指定对应的命名参数名：

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    @Query("select u from User u where u.email = :email and u.status = :status")
    List<User> findByEmailAndStatus(@Param("email") String email, @Param("status") String status);
}

这种方式的好处是参数顺序随便换都不会出错，可读性也更强，我个人推荐优先用这种写法。

3. 原生SQL查询的参数问题 #

如果你的查询用了nativeQuery = true，参数规则和JPQL是一样的——要么用?1位置参数（保证顺序一致），要么用@Param绑定命名参数。比如正确的原生SQL写法：

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    @Query(value = "select * from users where email = :email and status = :status", nativeQuery = true)
    List<User> findByEmailAndStatus(@Param("email") String email, @Param("status") String status);
}

最后检查要点 #

• 确认查询语句中的参数个数和方法参数个数完全一致，没有多写或少写占位符
• 用命名参数时，@Param里的名称要和查询里的:xxx完全匹配（大小写敏感哦）
• 位置参数要严格对应方法参数的顺序，从1开始计数

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