无法在JPA Repository中通过Native Query实现多字段DTO投影

问题根源 #

1. SQL别名写法错误：用单引号包裹别名（as 'firstName'），导致数据库返回的列名并非预期的firstName，而是带单引号的字符串标识，Spring Data无法匹配DTO/接口的字段。
2. 原生查询返回的是Object[]数组，Spring Data无法自动将其转换为自定义DTO类，必须显式配置结果集映射。

解决方案一：修复SQL别名+使用@SqlResultSetMapping实现类投影 #

步骤1：修正Repository中的SQL语句 #

去掉别名的单引号，确保列别名与DTO字段名一致，同时指定结果集映射：

public interface CustomerDetailRepository extends JpaRepository<CustomerDetail, Integer> {
    @Query(
           value = "SELECT first_name as firstName, last_name as lastName FROM customer_details where id=?1 order by customerId desc limit 1", 
           nativeQuery = true,
           resultSetMapping = "CustomCustomerDTOMapping"
    )
    CustomCustomerDTO findById2(String id);
}

步骤2：在实体类上配置结果集映射 #

在CustomerDetail实体类上添加@SqlResultSetMapping，绑定DTO构造方法与查询列：

@Entity
@SqlResultSetMapping(
    name = "CustomCustomerDTOMapping",
    classes = @ConstructorResult(
        targetClass = CustomCustomerDTO.class,
        columns = {
            @ColumnResult(name = "firstName", type = String.class),
            @ColumnResult(name = "lastName", type = String.class)
        }
    )
)
public class CustomerDetail {
    // 实体类原有字段、注解及方法
}

步骤3：确认DTO构造方法有效性 #

你的CustomCustomerDTO已包含(String firstName, String lastName)构造方法，无需修改。

解决方案二：修复SQL别名+使用接口投影 #

如果使用接口投影，只需修正SQL别名，确保接口方法名与别名驼峰对应即可：

步骤1：修正Repository中的SQL语句 #

public interface CustomerDetailRepository extends JpaRepository<CustomerDetail, Integer> {
    @Query(
           value = "SELECT first_name as firstName, last_name as lastName FROM customer_details where id=?1 order by customerId desc limit 1", 
           nativeQuery = true
    )
    CustomerObject findById2(String id);
}

步骤2：确认接口方法匹配 #

你的CustomerObject接口已定义getFirstName()和getLastName()，与SQL别名firstName、lastName对应，无需修改。

注意：此方案要求Spring Data JPA版本在2.0及以上，低版本可能不支持原生查询的接口投影自动映射。

验证要点 #

• 确认数据库方言支持无引号别名（MySQL中若别名含特殊字符，可用反引号包裹，如as `first-name``）。
• 检查DTO构造方法的参数类型、顺序与@ColumnResult定义完全一致。

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