Spring Data JPA中FetchableFluentQuery无法动态选择实体指定字段

你遇到的问题核心在于返回类型是完整的User实体类。Spring Data JPA在构建User实体实例时，需要确保实体的状态完整性（比如必须包含@Id标注的主键字段），而且实体类的设计要求所有属性都能被实例化（即使值为null），因此即便你调用了project(fields)指定字段，JPA依然会查询实体映射的所有列来填充对象。

解决方案1：使用DTO接收部分字段结果 #

这是最直接且推荐的方式，创建一个仅包含你需要字段的DTO类：

data class UserDto(
    val userName: String?,
    val displayName: String?
)

然后调整getUsers方法的返回类型，并在FluentQuery中指定转换为DTO类型：

private fun getUsers(
    spec: Specification<User>,
    pageRequest: PageRequest,
    fields: Set<String>,
): List<UserDto> {
    val result = userRepository.findBy(spec) { query: FluentQuery.FetchableFluentQuery<User> ->
        query.project(fields)
            .page(pageRequest)
            .asType(UserDto::class.java) // 指定结果转换为DTO
    }
    return result.content
}

此时底层执行的SQL会严格按照你指定的userName和displayName字段进行查询。

解决方案2：返回实体的局限性（不推荐） #

如果你坚持要返回User实体，必须在fields中包含id（@Id字段），因为JPA需要主键来管理实体状态。但即使这样，JPA依然可能会查询其他关联或嵌入式字段（比如你的name是@Embedded类型）——因为实体的结构要求这些属性存在，所以这种方式无法达到仅查询指定字段的目的，不推荐使用。

补充说明 #

project方法的作用是限制查询返回的字段，但它的行为依赖于最终的返回类型：

• 当返回类型是DTO或简单类型时，会严格按照指定字段查询；
• 当返回类型是实体时，JPA优先保证实体的完整性，会自动补充查询实体必需的字段。

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