自定义MariaDB查询端点报错，JPA映射POJO遇问题求助

核心问题拆解 #

• 开启nativeQuery=true时，SQL语句错误包含POJO全类名，触发原生SQL语法错误
• 关闭nativeQuery=true时，JPA查询验证不通过，导致Bean创建失败
• 终端执行原生SQL正常，说明SQL逻辑本身无问题，故障出在JPA查询映射配置环节

可能原因及解决步骤 #

1. POJO未正确配置为JPA可映射的目标类 #

场景A：TestRequestDB是DTO（仅用于接收查询结果，无@Entity注解）

方案1：使用Spring Data接口投影

创建投影接口，方法名与查询返回的列名（或别名）一一对应：

public interface TestProjection {
    Long getId();
    String getTest1();
}

Repository中编写查询（JPQL或原生SQL均可）：

@Repository
public interface TestRepository extends JpaRepository<TestEntity, Long> {
    // JPQL写法（TestEntity是对应test表的实体类）
    @Query("select t.id as id, t.test1 as test1 from TestEntity t")
    List<TestProjection> findTestData();

    // 原生SQL写法
    @Query(value = "select id, test1 from test", nativeQuery = true)
    List<TestProjection> findTestData();
}

方案2：使用DTO构造方法映射（仅JPQL支持）

给TestRequestDB添加与查询列顺序一致的全参构造方法：

public class TestRequestDB {
    private Long id;
    private String test1;

    public TestRequestDB(Long id, String test1) {
        this.id = id;
        this.test1 = test1;
    }
    // getter、setter可选
}

Repository中用JPQL调用DTO构造方法（必须使用实体类名而非数据库表名）：

@Repository
public interface TestRepository extends JpaRepository<TestEntity, Long> {
    @Query("select new com.yourpackage.TestRequestDB(t.id, t.test1) from TestEntity t")
    List<TestRequestDB> findTestData();
}

场景B：TestRequestDB是实体类

给TestRequestDB添加JPA实体注解，绑定数据库表：

@Entity
@Table(name = "test") // 指定对应数据库表名
public class TestRequestDB {
    @Id
    private Long id;
    private String test1;

    // 必须有无参构造方法，全参构造方法、getter、setter按需添加
    public TestRequestDB() {}
}

Repository可直接使用Spring Data提供的方法，或自定义查询：

@Repository
public interface TestRepository extends JpaRepository<TestRequestDB, Long> {
    // 自定义JPQL查询仅返回id和test1
    @Query("select t.id, t.test1 from TestRequestDB t")
    List<Object[]> findTestData();
}

2. @Query语句语法错误 #

• 原生SQL模式（nativeQuery=true）：必须写纯数据库原生SQL，禁止使用JPQL的new语法和实体类名。错误示例：

  @Query(value = "select new com.xxx.TestRequestDB(id, test1) from test", nativeQuery = true)
  

  正确写法：

  @Query(value = "select id, test1 from test", nativeQuery = true)
  

• JPQL模式（nativeQuery=false）：必须使用实体类名和实体属性名，而非数据库表名和列名。错误示例：

  @Query("select id, test1 from test")
  

  正确写法（假设实体类为TestEntity）：

  @Query("select t.id, t.test1 from TestEntity t")
  

验证步骤 #

1. 确认实体类（若用JPQL）已正确标注@Entity和@Table，属性与数据库列名匹配（可通过@Column指定映射关系）
2. 检查@Query语句：原生SQL用数据库表/列名，JPQL用实体类/属性名
3. 测试Repository方法，验证返回结果是否正确映射到目标类

内容的提问来源于stack exchange，提问作者Jérôme Martineau