@Basic(FetchType.LAZY)@Lob配合@EntityGraph无法即时加载问题求助

以下是几个可行的排查和解决方向：

1. 验证EntityGraph的应用方式是否正确 #

Panache的findAll()链式调用传递hint时可能存在传递失效情况，可尝试直接通过EntityManager创建查询验证：

EntityManager em = Panache.getEntityManager();
EntityGraph<Batch> graph = em.getEntityGraph("withLobs");

TypedQuery<Batch> query = em.createQuery(
    "SELECT b FROM Batch b ORDER BY b.creationDate DESC", Batch.class)
    .setHint(QueryHints.HINT_FETCHGRAPH, graph)
    .setFirstResult((pagination.page - 1) * pagination.limit)
    .setMaxResults(pagination.limit);

List<Batch> b = query.getResultList();

若该方式生效，说明Panache链式调用的hint传递存在问题，可考虑封装为自定义Panache查询方法。

2. 使用FetchProfile替代EntityGraph #

对于懒加载的基本字段（如Lob），Hibernate的FetchProfile兼容性更稳定：

• 在实体类上定义FetchProfile：

@Entity
@Table(name = "batch")
@FetchProfile(name = "fetchLobs", fetchOverrides = {
    @FetchProfile.FetchOverride(entity = Batch.class, association = "json", mode = FetchMode.JOIN),
    @FetchProfile.FetchOverride(entity = Batch.class, association = "log", mode = FetchMode.JOIN)
})
public class Batch extends PanacheEntityBase {
    // 原有字段定义
}

• 查询时激活该Profile：

EntityManager em = Panache.getEntityManager();
em.unwrap(Session.class).enableFetchProfile("fetchLobs");

List<Batch> b = Batch.findAll(Sort.descending("creationDate"))
    .page(Page.of(pagination.page - 1, pagination.limit))
    .list();

em.unwrap(Session.class).disableFetchProfile("fetchLobs");

3. 调整Lob字段的数据库适配配置 #

部分数据库驱动对懒加载Lob有特殊要求，需明确字段类型并添加对应配置：

• 修改字段注解（根据数据库调整columnDefinition）：

@Basic(fetch = FetchType.LAZY)
@Lob
@Column(name = "json", columnDefinition = "BYTEA") // PostgreSQL用BYTEA，MySQL用LONGBLOB
public byte[] json;

@Basic(fetch = FetchType.LAZY)
@Lob
@Column(name = "`log`", columnDefinition = "BYTEA")
public byte[] log;

• 在application.properties中添加数据库适配配置（以PostgreSQL为例）：

quarkus.hibernate-orm.properties.hibernate.jdbc.lob.non_contextual_creation=true

4. 显式使用JOIN FETCH强制加载 #

直接在JPQL中通过JOIN FETCH强制加载Lob字段，绕过EntityGraph的潜在问题：

List<Batch> b = Batch.find("SELECT b FROM Batch b JOIN FETCH b.json JOIN FETCH b.log ORDER BY b.creationDate DESC")
    .page(Page.of(pagination.page - 1, pagination.limit))
    .list();

5. 完善字节码增强配置 #

补充增强插件的额外参数，确保字节码增强完整：

<plugin>
  <groupId>org.hibernate.orm.tooling</groupId>
  <artifactId>hibernate-enhance-maven-plugin</artifactId>
  <executions>
    <execution>
      <configuration>
        <failOnError>true</failOnError>
        <enableLazyInitialization>true</enableLazyInitialization>
        <enableDirtyTracking>true</enableDirtyTracking>
        <enableAssociationManagement>true</enableAssociationManagement>
      </configuration>
      <goals>
        <goal>enhance</goal>
      </goals>
    </execution>
  </executions>
</plugin>

同时确认Quarkus构建日志中存在Hibernate Bytecode Enhancement is enabled的提示，验证增强已生效。

内容的提问来源于stack exchange，提问作者Luca Basso Ricci