如何将Spring Pageable中嵌入式实体属性转为JPA Order对象？

这个问题的核心原因是：JPA Criteria API的Root.get()方法只能识别单个层级的属性名，无法直接解析带点号的嵌套路径（比如bar.value）。嵌入式实体（@Embeddable）的属性需要逐层获取对应的Path对象，不能一步到位。

解决方案：解析属性路径，逐层构建Path #

我们可以写一个工具方法，把带点的属性路径拆分成单个属性段，然后循环地从Root开始逐层获取Path，最终得到嵌套属性的Path对象。

步骤1：实现路径解析工具方法

import jakarta.persistence.criteria.Path;
import jakarta.persistence.criteria.Root;

public static <T> Path<?> getNestedPath(Root<T> root, String propertyPath) {
    String[] pathSegments = propertyPath.split("\\.");
    Path<?> currentPath = root;
    for (String segment : pathSegments) {
        currentPath = currentPath.get(segment);
    }
    return currentPath;
}

步骤2：修改原有的排序转换代码

把原来直接调用root.get(springOrder.getProperty())的地方，替换成调用上面的工具方法，同时还要处理升序/降序的逻辑：

pageable.getSort().get().forEach(springOrder -> {
    Path<?> nestedPath = getNestedPath(root, springOrder.getProperty());
    if (springOrder.isAscending()) {
        jpaOrders.add(getBuilder().asc(nestedPath));
    } else {
        jpaOrders.add(getBuilder().desc(nestedPath));
    }
});

原理说明 #

以你的bar.value路径为例：

1. 工具方法会把bar.value拆分为["bar", "value"]两个分段
2. 先通过root.get("bar")获取到对应嵌入式实体Bar的Path<Bar>对象
3. 再通过这个Path对象调用get("value")，最终得到对应Bar.value的Path<String>对象
4. 用这个最终的Path创建JPA Order，就不会再抛出"无法找到属性"的异常了

额外注意点 #

• 确保属性路径的拼写完全匹配实体类中的属性名（JPA默认区分大小写）
• 如果遇到更深层级的嵌套路径（比如a.b.c），这个工具方法同样适用，会自动逐层解析

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