如何重写Spring JPA的Sort.Order参数以兼容数据库字段变更？

现有场景：数据库中PersonEntity的字段从lastname改为surname，但API调用者的书签仍使用旧参数?sort=lastname，需要让?sort=lastname和?sort=surname实现相同的排序效果，同时不修改API用户的书签。

原有代码实现如下：

@GetMapping
public void getPersons(..., Pageable pageable) {
   pageable.getSort().getOrderFor("lastname"); // TODO 替换为'surname'
}

@Entity
class PersonEntity {
     String lastname;
     // String surname;
}

由于Pageable和Sort均未提供setter方法，该如何实现参数的映射转换？

目前参考@M. Deinum的建议，实现了重写整个Pageable排序逻辑的方案，但不确定这是否是最优解：

if (pageable != null
        && pageable.getSort() != null
        && pageable.getSort().isSorted()
        && pageable.getSort().getOrderFor("lastname") != null) {
    List<Sort.Order> orders = pageable.getSort().stream()
            .map(order -> {
                String property = order.getProperty();
                if (StringUtils.equals(property, "lastname")) 
                       property = "surname";
                return new Sort.Order(order.getDirection(), property, order.getNullHandling());
            })
            .collect(Collectors.toList());
    PageRequest.of(pageable.getPageNumber(), pageable.getPageSize(), Sort.by(orders));
}

方案分析 #

上述方案是完全可行的，核心逻辑是通过流式遍历排序规则，将旧字段名映射为新字段名后重新构建PageRequest。如果后续有多个字段需要兼容旧参数，可以将映射关系抽离为配置表，提升扩展性：

// 定义全局字段映射表
private static final Map<String, String> SORT_FIELD_MAPPING = Map.of(
    "lastname", "surname"
    // 可添加更多字段映射
);

// 替换原map中的字段判断逻辑
String property = SORT_FIELD_MAPPING.getOrDefault(order.getProperty(), order.getProperty());

如果项目中有多个接口需要处理类似的参数兼容，还可以通过自定义PageableHandlerMethodArgumentResolver实现全局处理：

1. 自定义Resolver继承PageableHandlerMethodArgumentResolver
2. 重写resolveArgument方法，在构建Pageable实例前完成字段映射
3. 将自定义Resolver注册到Spring容器中

但如果只是单个字段的兼容需求，接口内直接转换的方案已经足够简洁，无需引入全局配置的复杂度。

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