跨EntityManager迁移Criteria-API查询：如何合并至新EntityManager？

这个问题的核心原因是**CriteriaQuery和创建它的EntityManager/CriteriaBuilder是强绑定的**，而且EntityManager本身有生命周期（通常和请求或事务绑定）。你在RestController中创建的EntityManager会在请求结束后被容器关闭，当单例Service后续尝试用这个已经失效的查询执行时，自然会抛出Session/EntityManager is closed异常。

正确的做法：不要存储CriteriaQuery实例，而是封装查询构建逻辑 #

你应该把构建查询的逻辑（比如筛选条件、投影、关联等）封装成可复用的方法，每次需要执行查询时，用当前有效的EntityManager重新构建CriteriaQuery，而不是复用之前创建的实例。

示例代码：

1. 先封装查询构建逻辑（可以单独写一个工具类，或者放在Service内部）：

public class UserQueryHelper {
    // 封装构建"查询活跃用户"的逻辑
    public static CriteriaQuery<User> buildActiveUsersQuery(CriteriaBuilder cb) {
        CriteriaQuery<User> query = cb.createQuery(User.class);
        Root<User> userRoot = query.from(User.class);
        
        // 这里写你的查询条件、投影、排序等逻辑
        query.select(userRoot)
             .where(cb.equal(userRoot.get("isActive"), Boolean.TRUE))
             .orderBy(cb.asc(userRoot.get("createTime")));
        
        return query;
    }
}

2. 在单例Service中注入EntityManager，每次执行查询时用当前的EntityManager构建并执行查询：

@Service
public class UserService {
    @PersistenceContext
    private EntityManager entityManager;

    public List<User> getActiveUsers() {
        // 获取当前有效的CriteriaBuilder
        CriteriaBuilder cb = entityManager.getCriteriaBuilder();
        // 用当前的cb构建查询
        CriteriaQuery<User> query = UserQueryHelper.buildActiveUsersQuery(cb);
        // 执行查询
        return entityManager.createQuery(query).getResultList();
    }
}

为什么不能复用旧的CriteriaQuery？ #

• CriteriaQuery内部持有和创建它的EntityManager相关的上下文信息，一旦原EntityManager关闭，这些上下文就失效了，无法在新的EntityManager中复用。
• EntityManager本身不是线程安全的，也不应该被长期持有（比如在单例Bean中存储），Spring会通过@PersistenceContext自动管理它的生命周期，确保你在事务或请求范围内拿到的是有效的实例。

额外提示：复用查询片段 #

如果你的查询有很多重复的筛选条件（比如通用的软删除过滤），可以把这些片段封装成可复用的Predicate方法，比如：

public static Predicate addSoftDeleteFilter(CriteriaBuilder cb, Root<?> root) {
    return cb.equal(root.get("deleted"), Boolean.FALSE);
}

然后在构建查询时调用：

query.where(
    cb.and(
        addSoftDeleteFilter(cb, userRoot),
        cb.equal(userRoot.get("isActive"), Boolean.TRUE)
    )
);

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