如何使用CriteriaBuilder基于jsonb列中的字段实现INNER JOIN？

你遇到的「找不到命名属性」错误，核心原因是JPA Criteria API的join()方法只能接收实体类中预先定义的关联属性名称（比如用@ManyToOne/@OneToOne注解标记的关联字段），但你传入的是通过jsonb_extract_path_text函数动态计算的JSON字段值，JPA无法将这个动态值识别为实体的合法属性，因此报错。

因为两张表的关联字段存在于JSONB列中，没有在JPA实体映射中定义关联关系，所以需要手动构建连接条件，而非依赖自动映射的关联属性。以下是两种可行的实现方式：

方式一：双Root + WHERE条件模拟内连接 #

通过将两个实体都加入查询的FROM子句，再通过WHERE条件指定JSON提取字段与另一表主键的关联关系，模拟内连接逻辑：

public final CriteriaQuery<TutenBookingMacarena> createRatedBookings(
        MacarenaBookingSearchFilter filters,
        Integer page,
        Integer pageSize,
        Security security
) {

    final CriteriaBuilder builder = entityManager.getCriteriaBuilder();
    final CriteriaQuery<TutenBookingMacarena> criteria = builder.createQuery(TutenBookingMacarena.class);
    
    // 主表Root
    final Root<TutenBookingMacarena> bookingRoot = criteria.from(TutenBookingMacarena.class);
    // 关联表Root（相当于交叉连接）
    final Root<TutenCaseMacarena> caseRoot = criteria.from(TutenCaseMacarena.class);
    
    // 提取booking表data字段中的caseId值
    Expression<String> bookingCaseId = builder.function(
            "jsonb_extract_path_text",
            String.class,
            bookingRoot.get("data"),
            builder.literal("caseId")
    );
    
    // 添加内连接条件：booking的caseId等于case表的主键id
    criteria.where(builder.equal(bookingCaseId, caseRoot.get("id")));
    
    // 可选：添加去重，避免交叉连接产生重复结果
    criteria.distinct(true);
    
    // 后续分页、过滤逻辑...
    return criteria;
}

方式二：使用Join + ON条件 #

部分JPA实现（如Hibernate）支持直接通过join()方法指定关联实体，并手动添加ON条件，写法更贴近SQL的内连接语法：

public final CriteriaQuery<TutenBookingMacarena> createRatedBookings(
        MacarenaBookingSearchFilter filters,
        Integer page,
        Integer pageSize,
        Security security
) {

    final CriteriaBuilder builder = entityManager.getCriteriaBuilder();
    final CriteriaQuery<TutenBookingMacarena> criteria = builder.createQuery(TutenBookingMacarena.class);
    final Root<TutenBookingMacarena> bookingRoot = criteria.from(TutenBookingMacarena.class);
    
    // 创建内连接，指定关联实体类型
    Join<TutenBookingMacarena, TutenCaseMacarena> caseJoin = bookingRoot.join(
            TutenCaseMacarena.class,
            JoinType.INNER
    );
    
    // 提取booking表data字段中的caseId
    Expression<String> bookingCaseId = builder.function(
            "jsonb_extract_path_text",
            String.class,
            bookingRoot.get("data"),
            builder.literal("caseId")
    );
    
    // 手动指定连接条件
    caseJoin.on(builder.equal(bookingCaseId, caseJoin.get("id")));
    
    // 后续分页、过滤逻辑...
    return criteria;
}

• 类型匹配：如果caseId在JSON中是数字类型（比如Long），需要将jsonb_extract_path_text的结果转换为对应类型，避免类型不匹配错误。例如：

  Expression<Long> bookingCaseId = builder.function(
          "cast",
          Long.class,
          builder.function(
              "jsonb_extract_path_text",
              String.class,
              bookingRoot.get("data"),
              builder.literal("caseId")
          ),
          builder.literal("bigint")
  );
  

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