QueryDSL泛型查询JPA实体如何使用MappedSuperclass超类字段过滤排序

@MappedSuperclass 标记的映射超类不属于JPA受管实体，没有独立对应的数据库表，QueryDSL为其生成的Q类仅用于给具体实体子类复用字段元数据，不能直接实例化作为查询根使用。
直接实例化QSystemDataBase时，该Q实例绑定的默认路径别名是systemDataBase，和传入泛型方法的实际业务实体EntityPath<T>的别名不匹配，最终生成的JPQL会出现不存在的路径引用systemDataBase.lang，触发QuerySyntaxException。

核心逻辑是放弃硬编码实例化超类Q对象，所有查询路径都基于传入的具体实体EntityPath动态构建，保证路径别名和查询根完全匹配。

• 通用路径提取工具
  基于QueryDSL的Expressions工具类，从当前查询根实体路径上提取超类定义的公共字段路径，不需要依赖固定的Q类实例：

  // 提取DescriptionBase中定义的lang字段路径
  private <T> StringPath resolveLangPath(EntityPath<T> rootPath) {
      return Expressions.stringPath(rootPath, DescriptionBase.fields.lang);
  }
  
  // 提取SystemDataBase中定义的order字段路径
  private <T> NumberPath<Integer> resolveOrderPath(EntityPath<T> rootPath) {
      return Expressions.numberPath(Integer.class, rootPath, SystemDataBase.fields.order);
  }
  

  上述方法中用到的fields常量是QueryDSL APT插件自动生成的属性元数据，比硬编码字段名字符串更安全，重构字段时会同步校验。

• 改造泛型查询方法
  用动态解析得到的字段路径拼接过滤、排序逻辑，完全适配所有继承自SystemDataBase的业务实体：

  public <T extends SystemDataBase> List<T> loadStaticReferenceData(
      EntityPath<T> entityPath,
      String lang
  ) {
      StringPath langPath = resolveLangPath(entityPath);
      NumberPath<Integer> orderPath = resolveOrderPath(entityPath);
  
      return jpaQueryFactory.selectFrom(entityPath)
              .where(langPath.eq(lang))
              .orderBy(orderPath.asc())
              // 后续如果要基于超类字段加其他过滤、排序，直接用动态解析的路径拼接即可
              .fetch();
  }
  

• 方法调用
  调用时直接传入具体业务实体的Q类实例即可，不需要额外调整：

  // 加载员工账号类型
  List<EmpAccountType> accountTypes = loadStaticReferenceData(
      QEmpAccountType.empAccountType, 
      "zh_CN"
  );
  // 加载雇主类型
  List<EmployerType> employerTypes = loadStaticReferenceData(
      QEmployerType.employerType, 
      "zh_CN"
  );
  

注意：如果后续超类新增公共查询字段，只需要对应新增一个路径解析方法，不需要修改泛型查询的核心逻辑，也不需要改动各业务实体的调用代码。

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