Eclipse中Gradle项目Spring Data JPA未加@Param注解报错咨询

这个问题不是Eclipse对Gradle的兼容性缺陷，核心原因是Eclipse编译项目时没有开启方法参数名保留的编译选项，导致Spring Data JPA无法通过反射获取接口方法的形参名，无法匹配JPQL中的命名参数。

Spring Data JPA支持省略@Param注解的前提，是编译后的字节码中必须保留方法的形参元信息，这需要Java编译器开启-parameters参数（Java 8及以上版本支持）。你提到的几个正常运行的场景，都是因为编译环节正确加载了这个参数：

• 命令行执行./gradlew bootRun时，Spring Boot Gradle插件会自动给Java编译任务添加-parameters参数，Gradle调用标准javac编译出的字节码自带参数名信息，运行自然正常。
• Eclipse中运行Maven项目时，Eclipse的Maven集成插件（m2e）可以正确识别Spring Boot Maven插件默认配置的-parameters参数，自动同步给Eclipse内置的Java编译器（ECJ），编译产物符合要求。
• IntelliJ IDEA运行Gradle项目时，默认将编译、运行流程完全委托给Gradle，直接使用Gradle的编译输出，和命令行运行的行为完全一致，不会出现参数丢失。

Eclipse+Gradle场景报错的具体逻辑是：Eclipse的Gradle集成插件（Buildship）默认不会将构建流程完全委托给Gradle，而是使用自带的ECJ编译器独立编译Java源文件。旧版本的Buildship不会主动读取Spring Boot Gradle插件隐式配置的-parameters编译参数，也不会自动给ECJ添加对应配置，最终编译出来的字节码里没有保留方法形参名。Spring Data JPA启动时解析Repository方法，既找不到@Param注解指定的参数名，又拿不到反射可读的形参名，就会抛出你看到的IllegalArgumentException。
你切换OpenJDK、OracleJDK、GraalVM都无法解决问题，是因为问题和运行时用的JDK无关，出在编译环节的参数配置上。

不需要给所有Repository方法逐个添加@Param，任选以下一种方案即可修复：

• 开启Gradle委托构建（推荐）
  右键项目 -> 进入Properties -> 选择Gradle配置页，勾选Delegate build and run actions to Gradle，保存后清理并重新构建项目。之后Eclipse的编译、运行都会直接调用Gradle任务，和命令行行为完全一致，不会再出现配置差异问题。
• 手动开启Eclipse编译器的参数保留选项
  如果不想委托构建，可以手动给编译器加配置：
  • 全局配置：打开Window -> Preferences -> Java -> Compiler，勾选Store information about method parameters (usable via reflection)，保存后全量重编译。
  • 单项目配置：右键项目 -> Properties -> Java Compiler，勾选上述选项即可，不需要修改全局配置。
• 在Gradle配置中显式声明编译参数
  在build.gradle中添加如下配置，强制指定Java编译参数，新版本的Buildship导入项目时会自动识别该配置并同步给ECJ，无需手动修改IDE设置：

  tasks.withType(JavaCompile) {
      options.compilerArgs += '-parameters'
  }
  

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