Spring Data JPA接口投影返回空值问题求助

我之前也碰到过类似的接口投影映射踩坑经历，结合你贴的代码来看，问题大概率出在投影字段的映射匹配或者Spring Data JPA对嵌套属性的处理上，咱们一步步来排查解决：

1. 显式绑定投影接口与查询别名 #

虽然你的SQL别名看起来和投影getter对应的属性名一致，但Spring Data JPA的接口投影对字段映射的匹配度要求很高，建议在投影接口的方法上用@Value注解明确指定映射关系，避免框架自动匹配时的歧义：

import org.springframework.beans.factory.annotation.Value;
import java.math.BigDecimal;

public interface UserAmountProjection {
    @Value("#{target.customerId}")
    String getCustomerId();

    @Value("#{target.amountThreshold}")
    Long getAmountThreshold();

    @Value("#{target.amount}")
    BigDecimal getAmount();
}

2. 调整查询写法绕开JPQL解析歧义 #

你当前用的是JPQL显式JOIN ... ON写法，虽然数据库执行正常，但Spring Data JPA在处理嵌套属性（比如r.id.amountThreshold）的投影映射时可能有兼容问题，可以尝试两种调整：

方案一：改用原生SQL查询

直接用数据库列名编写查询，加上nativeQuery=true，绕开JPQL的属性解析逻辑：

@Query(value = """
    SELECT u.CUSTOMER_ID AS customerId, r.AMOUNT_THRESHOLD AS amountThreshold, SUM(r.AMOUNT) AS amount
    FROM RECORD r
    JOIN USER u ON r.ACCOUNTT_NUMBER = u.ACCOUNTT_NUMBER
    WHERE u.CUSTOMER_ID IN ?1
    GROUP BY u.CUSTOMER_ID, r.AMOUNT_THRESHOLD
    ORDER BY u.CUSTOMER_ID, r.AMOUNT_THRESHOLD
""", nativeQuery = true)
List<UserAmountProjection> findAmountByCustomerID(List<String> customerIds);

注意这里要用数据库的实际列名，不是实体类的属性名。

方案二：利用实体关联关系简化查询

在RecordEntity中添加与UserEntity的关联，让JPQL的解析更清晰：

// 在RecordEntity中新增关联字段
@ManyToOne
@JoinColumn(name = "ACCOUNTT_NUMBER", referencedColumnName = "ACCOUNTT_NUMBER", insertable = false, updatable = false)
private UserEntity user;

然后修改JPQL查询：

@Query("""
    SELECT r.user.customerId AS customerId, r.id.amountThreshold AS amountThreshold, SUM(r.amount) AS amount
    FROM RecordEntity r
    WHERE r.user.customerId IN ?1
    GROUP BY r.user.customerId, r.id.amountThreshold
    ORDER BY r.user.customerId, r.id.amountThreshold
""")
List<UserAmountProjection> findAmountByCustomerID(List<String> customerIds);

3. 用DTO类投影做对比验证 #

如果接口投影还是有问题，可以先尝试用DTO类投影验证核心查询逻辑是否正确：

import lombok.AllArgsConstructor;
import lombok.Data;
import java.math.BigDecimal;

@Data
@AllArgsConstructor
public class UserAmountDTO {
    private String customerId;
    private Long amountThreshold;
    private BigDecimal amount;
}

然后修改Repository的查询语句，使用构造器表达式：

@Query("""
    SELECT new com.yourproject.dto.UserAmountDTO(u.customerId, r.id.amountThreshold, SUM(r.amount))
    FROM RecordEntity r
    JOIN UserEntity u ON r.id.accountNumber = u.accountNumber
    WHERE u.customerId IN ?1
    GROUP BY u.customerId, r.id.amountThreshold
    ORDER BY u.customerId, r.id.amountThreshold
""")
List<UserAmountDTO> findAmountByCustomerID(List<String> customerIds);

如果这个DTO能正确返回数据，说明核心查询逻辑没问题，问题确实集中在接口投影的映射上，再回到第一步调整接口注解即可。

额外小检查 #

最后再确认下实体类的字段拼写：我注意到你实体类的@Column里写的是ACCOUNTT_NUMBER（多了一个T），不过你说数据库里的SQL能正常运行，应该是数据库列名确实如此，这个没问题；另外Repository方法的参数名CustomerID是大写，建议改成小写customerIds更符合编码规范~

内容来源于stack exchange