Native Query返回OveroptimisationDto时类型转换错误排查

下面是针对你遇到的字段映射相关问题的排查步骤，按优先级来：

1. 核对SQL返回列和DTO字段的命名匹配 #

这是最常见的触发原因：

• 无论数据库大小写是否敏感，SQL查询的返回列名（或别名）必须和DTO的字段名完全对应，驼峰和下划线不能混着用。
  举个实际例子：
  DTO代码：

  public class OveroptimisationDto {
      private Long userId;
      private String userNickname;
  }
  

  对应的Native Query就得这么写：

  SELECT u.id AS userId, u.nickname AS userNickname FROM user u
  

  要是习惯下划线命名，也可以把DTO字段改成userId对应SQL别名user_id，保持两边一致即可。

2. 检查DTO的构造方法是否符合要求 #

Spring Data JPA转DTO时，默认会通过全参构造方法实例化对象：

• 如果DTO没有全参构造，或者构造方法的参数顺序、类型和SQL返回列的顺序、类型不匹配，就会触发转换器找不到的错误。
• 要是不想写全参构造，或者列名和字段名没法统一，就用@SqlResultSetMapping指定映射关系，比如：

  @SqlResultSetMapping(
      name = "OveroptimisationDtoMap",
      classes = @ConstructorResult(
          targetClass = OveroptimisationDto.class,
          columns = {
              @ColumnResult(name = "user_id", type = Long.class),
              @ColumnResult(name = "nick_name", type = String.class)
          }
      )
  )
  

  然后在Repository的查询方法上关联这个映射：

  @Query(nativeQuery = true, value = "SELECT u.id AS user_id, u.nickname AS nick_name FROM user u", resultSetMapping = "OveroptimisationDtoMap")
  List<OveroptimisationDto> fetchOveroptimisationData();
  

3. 确认DTO的字段可访问 #

• 如果DTO的字段是private，必须有对应的getter/setter方法，或者用Lombok的@Data/@Getter/@Setter自动生成，不然Spring反射无法完成赋值。
• 不要给DTO字段加final修饰，除非你完全靠构造方法注入所有字段。

4. 直接验证SQL的返回结构 #

把你的Native Query复制到数据库客户端（比如Navicat、pgAdmin）执行，确认返回的列数、列名、数据类型和DTO的字段完全对应：

• 比如SQL返回了3列但DTO只有2个字段，或者某列是INT但DTO字段是Long，都会导致映射失败。

5. 检查Repository方法的注解配置 #

• 确保用对注解：要么用@NativeQuery，要么用@Query(nativeQuery = true)，不要混用。
• 简单场景可以直接指定resultClass = OveroptimisationDto.class，前提是列名和字段名完全匹配，比如：

  @Query(value = "SELECT u.id AS userId, u.nickname AS userNickname FROM user u", nativeQuery = true, resultClass = OveroptimisationDto.class)
  List<OveroptimisationDto> getOveroptimisationList();
  

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