Quarkus SmallRye GraphQL多实体查询嵌套数据丢失问题求助

该行为是否正常？ #

这种行为完全不正常，不属于GraphQL规范或SmallRye GraphQL的预期表现，本质是多根查询执行时的持久化上下文冲突导致嵌套字段加载失效。

正确实现多独立实体查询的关键步骤 #

1. 隔离解析器的事务与实体上下文

同一请求中的多个根查询默认可能共享同一个JPA EntityManager或事务上下文，当第一个查询完成后上下文关闭，第二个查询中Person的懒加载嵌套字段（如addresses）会因实体脱管而无法加载。解决方式：

• 给每个根查询的解析器方法添加@Transactional注解，并指定REQUIRES_NEW事务类型，强制每个查询开启独立事务与实体上下文：

@GraphQLApi
public class PersonResolver {
    @Inject
    PersonRepository personRepo;

    @Query
    @Transactional(TxType.REQUIRES_NEW)
    public Person Person(@Name("id") String id) {
        return personRepo.findById(id);
    }
}

@GraphQLApi
public class WorkContractResolver {
    @Inject
    WorkContractContractRepository contractRepo;

    @Query
    @Transactional(TxType.REQUIRES_NEW)
    public WorkContract WorkContract(@Name("id") String id) {
        return contractRepo.findById(id);
    }
}

2. 主动预加载嵌套字段

如果实体类中嵌套字段使用懒加载（如JPA的@OneToMany(fetch = FetchType.LAZY)），即使隔离上下文，也可能因解析阶段未触发加载导致响应丢失数据。需在仓库层主动预加载：

• 使用JPQL的JOIN FETCH语法强制加载关联字段：

@ApplicationScoped
public class PersonRepository {
    @PersistenceContext
    EntityManager em;

    public Person findByIdWithAddresses(String id) {
        return em.createQuery(
            "SELECT p FROM Person p JOIN FETCH p.addresses WHERE p.id = :id",
            Person.class
        )
        .setParameter("id", id)
        .getSingleResult();
    }
}

• 对应解析器方法调用该预加载方法，确保POJO中嵌套字段已被填充。

3. 调整SmallRye GraphQL的并行执行配置

SmallRye默认会并行执行多个根查询，若上下文隔离不彻底，容易引发线程安全问题。可通过配置改为串行执行：
在application.properties中添加：

smallrye.graphql.execution.parallel=false

4. 保证解析器与仓库的线程安全性

• 禁止在Resolver或Repository类中持有全局的EntityManager实例，应通过方法注入或容器管理获取；
• 所有Repository方法应无状态，避免因线程共享导致的上下文混乱。

快速排查手段 #

• 开启SmallRye GraphQL的DEBUG日志，查看io.smallrye.graphql日志，确认两个查询的实体管理器实例是否一致；
• 在解析器方法中打印EntityManager的hashCode，若为同一值，说明上下文未成功隔离。

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