Spring Data JDBC QueryCreationException：自定义查询方法名被识别为属性

错误根源 #

你的代码存在两个关键问题，导致Spring Data框架未识别到自定义@Query注解，转而尝试解析方法名：

1. @Query注解导入错误：你大概率导入了JPA的javax.persistence.Query注解，而Spring Data JDBC需要使用专属的org.springframework.data.jdbc.repository.query.Query注解。错误的注解会让框架忽略自定义SQL，进而把retainDataBefore当成基于属性的查询方法，自然找不到retainData属性。
2. 实体类使用JPA专属注解：AuditRecord上的@Entity是JPA注解，会干扰Spring Data JDBC的解析逻辑，甚至可能让框架误将Repository当作JPA Repository处理。

修复步骤 #

1. 修正@Query注解导入
   在Repository类中，替换@Query的导入为Spring Data JDBC专属注解：

   import org.springframework.data.jdbc.repository.query.Query;
   import org.springframework.data.jdbc.repository.query.Modifying;
   

2. 替换实体类的JPA注解
   移除@Entity，改用Spring Data JDBC的映射注解，同时替换JPA的@Id和@Column：

   import org.springframework.data.relational.core.mapping.Column;
   import org.springframework.data.relational.core.mapping.Table;
   import org.springframework.data.annotation.Id;
   import lombok.Getter;
   import lombok.Setter;
   import lombok.AllArgsConstructor;
   import lombok.NoArgsConstructor;
   import java.sql.Timestamp;
   
   @Table(name = "audit_records")
   @Getter
   @Setter
   @AllArgsConstructor
   @NoArgsConstructor
   public class AuditRecord {
     @Id 
     @Column(name="id")
     private Long id;
   
     @Column(name = "created_on")
     private Timestamp date;
   }
   

3. 排查依赖冲突
   检查项目依赖，确保未同时引入Spring Data JPA和Spring Data JDBC。如果是Spring Boot项目，仅保留spring-boot-starter-data-jdbc依赖，移除spring-boot-starter-data-jpa。

验证修复 #

修正后，Spring Data JDBC会正确识别自定义SQL，不再解析方法名，retainDataBefore方法即可正常执行删除操作。

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