Spring Boot中JPA Sort.by("bId")按实体嵌套字段排序的原理探究

我在Spring Boot构建的GET API中遇到了一个意外但符合需求的输出：实体A和B为@OneToOne关联，使用JpaRepository查询A时，指定按"bId"排序，结果实际是按B.id降序排列，想搞懂内部实现原理。

实体定义 #

实体A #

@Entity
class A {
    ....
    @OneToOne
    @JoinColumn(name = "b_id")
    B b;
}

实体B #

@Entity
class B {
    Integer id;
    ....
}

Repository与分页排序配置 #

A的Repository接口 #

public interface ARepo extends JpaRepository<A,Integer>, JpaSpecificationExecutor<A> {
   ...
}

构建的Pageable对象 #

Pageable pageable = PageRequest.of(0, 10, Sort.by(Sort.Direction.DESC, "bId")); // 指定bId作为排序字段

执行findAll()方法后，结果按B.id降序排列，虽满足需求，但我想了解背后的逻辑。我查阅了Hibernate的"nested property path traversal"相关内容未找到答案，还怀疑是否和以下DTO及映射有关：

DTO与映射配置 #

ADto定义 #

@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
@FieldDefaults(level = AccessLevel.PRIVATE)
@JsonIgnoreProperties(ignoreUnknown = true)
public class ADto {
   Integer aId;
   ....
   Integer bId;
}

AMapper映射接口 #

@Mapper(componentModel = "spring", nullValueCheckStrategy = NullValueCheckStrategy.ALWAYS)
public interface AMapper {
    @Mapping(target = "bId", source = "b.id")
    ADto entityToDto(A refundInitiate);
}

原理解析 #

首先明确：DTO和映射逻辑完全不影响JPA的查询排序，排序是在数据库层面执行的，和后续的实体转DTO步骤无关。

JPA（底层为Hibernate）对排序字段的解析逻辑如下：

• 当指定排序字段为bId时，Hibernate先尝试在实体A中查找同名属性，但实体A只有b属性（关联B实体），没有bId。
• 接着Hibernate会将驼峰命名的bId转换为下划线格式b_id，这恰好匹配实体A中@JoinColumn(name = "b_id")定义的外键列名。
• 数据库中b_id列存储的就是B实体的id值，因此按b_id列降序排序，本质就是按B.id的值降序排列，最终结果自然和预期的按B.id排序一致。

另外补充：如果实体A中存在getBId()方法（比如Lombok自动生成），Hibernate也会将其视为属性解析，但本次场景的核心是外键列名的匹配逻辑。

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