Spring Data JPA命名参数报错排查：本地Java8环境正常但高环境抛出InvalidDataAccessApiUsageException

这个问题我之前也碰到过，核心原因是本地和服务器的Java编译参数不一致导致的。虽然两边都是Java8，但只有在编译时启用-parameters参数，Spring Data才能通过反射获取方法参数的原始名称；如果没开这个参数，又没给参数加@Param注解，就会触发你看到的错误。

下面是两个可行的解决方案，按兼容性优先排序：

方案一：添加@Param注解（最稳妥，兼容所有Java8+环境） #

直接在Repository方法的参数上加上@Param注解，明确指定命名参数的名称，这样不管编译参数如何，Spring Data都能准确匹配参数：

import org.springframework.data.repository.query.Param;

// 修改后的方法
@Query(value = "select l from TnncSetlmtSvcGrpStagingEntity l where l.runDate >=:runDate")
List<TnncSetlmtSvcGrpStagingEntity> findAllByRunDateGT(@Param("runDate") Date runDate);

这是Spring官方推荐的兼容写法，不会受编译环境的影响，适合跨环境部署的场景。

方案二：确保编译时启用-parameters参数 #

如果你不想添加@Param注解，可以调整项目的构建配置，强制启用Java8的-parameters编译参数，让class文件保留方法参数的原始名称。

Maven配置（pom.xml） #

在maven-compiler-plugin中添加-parameters编译参数：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <compilerArgs>
                    <arg>-parameters</arg>
                </compilerArgs>
            </configuration>
        </plugin>
    </plugins>
</build>

Gradle配置（build.gradle） #

在compileJava任务中添加编译参数：

compileJava {
    options.compilerArgs << '-parameters'
}

你本地环境可能已经通过IDE默认配置或者构建脚本开启了这个参数，但服务器的构建环境没有，所以才会出现本地正常、部署报错的情况。

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