最近JPA踩坑，使用自定义的@Query报出下面的异常：
org.springframework.dao.InvalidDataAccessApiUsageException: For queries with named parameters you need to use provide names for method parameters. Use @Param for query method parameters, or when on Java 8+ use the javac flag -parameters.; nested exception is java.lang.IllegalStateException: For queries with named parameters you need to use provide names for method parameters. Use @Param for query method parameters, or when on Java 8+ use the javac flag -parameters.
其实异常提示的很明显了，你需要使用@Param指定参数名称是什么，或者当你的编译器版本大于1.8的时候要对编译参数加上-parameters。
当前代码实体类和视图对象如下：
@Data@Entity@Table(name = "student")public class Student { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Integer id; // 主键 private Integer age; private String name; private Double salary; private String address;}
@Value@ToStringpublic class StudentVo { private String name; private Integer age;}
通过@Query注解返回视图对象列表 ：
public interface StudentRepository extends CrudRepository { @Query( "select new com.alphathur.jpademo.model.vo.StudentVo(name, age) from Student where salary = :salary ") List findStudentVo(Double salary);}
这个接口使用了‘ :参数名’ 来绑定参数，且没有对salary使用@Param参数，所以报错了。
这里提供三种方案解决问题：
1.加上@Param，将接口修改如下：
public interface StudentRepository extends CrudRepository { @Query( "select new com.alphathur.jpademo.model.vo.StudentVo(name, age) from Student where salary = :salary ") List findStudentVo(@Param("salary") Double salary);}
2.不加@Param，修改idea的编译器参数。用于本地环境。
如图选择 Preferences -> Build, Execution, Deployment -> Compiler -> Java Compiler.对当前项目加入-parameters参数。
Eclipse修改方式：
3.不加@Param，在pom.xml的build->plugins中添加如下的代码，指定maven编译时添加-parameters参数。用于线上环境。
org.apache.maven.plugins maven-compiler-plugin 1.8 1.8 -parameters
无论采用1，2，3 哪种方案，项目均不再报错。
JPA自定义@Query查询绑定参数的另一种形式是使用 ‘?参数位置’ 来绑定参数（参数位置从1开始计数），这种方式也是JPA默认的参数绑定方式。如下
@Query( "select new com.alphathur.jpademo.model.vo.StudentVo(name, age) from Student where salary = ?1 and age = ?2 ") List findStudentVoBySalaryAndAge(Double salary, Integer age);
这种查询即使不加@Param，编译器不做任何设置，也不会报错。
总结：
当使用JPA的@Query来自定义查询，如果选择了参数名的绑定方式，当编译器级别大于等于1.8且添加了-parameters，则可以不加@Param，否则必须添加@Param。
参考JPA官方手册：https://docs.spring.io/spring-data/jpa/docs/current/reference/html/#jpa.named-parameters
