Spring Data Repository find方法在子线程调用时阻塞无返回

这问题我之前帮同事排查过类似的，核心其实不只是Session的绑定——Spring Data Repository的操作依赖完整的数据访问上下文，包括ThreadLocal存储的Session/EntityManager，以及事务上下文，缺了任何一个都可能导致查询挂起无响应。结合你的情况，给你几个具体的排查方向和解决方案：

1. 事务上下文缺失是最常见的原因 #

主线程里调用Repository正常，大概率是因为主线程处于@Transactional注解的事务上下文里，而子线程默认不会继承这个上下文。哪怕你手动绑定了Session，没有事务的话，Hibernate的Session可能会处于“非活跃”状态，导致查询操作阻塞等待事务触发。

解决方法：用TransactionTemplate在子线程中手动管理事务，这是Spring官方推荐的编程式事务方式，能确保子线程有完整的事务上下文：

@Autowired
private TransactionTemplate transactionTemplate;
@Autowired
private YourRepository yourRepository;

// 子线程任务
Runnable queryTask = () -> {
    // 用TransactionTemplate包裹查询逻辑
    var result = transactionTemplate.execute(status -> {
        return yourRepository.findById(1L); // 这里的Repository调用会自动关联事务内的Session
    });
    // 处理查询结果
    System.out.println("子线程查询结果：" + result);
};

// 启动子线程
new Thread(queryTask).start();

2. 手动绑定Session的方式可能有误 #

如果你坚持手动绑定Session，要注意必须同时绑定SessionHolder到Spring的TransactionSynchronizationManager，并且开启事务——单纯打开Session是没用的，Spring Data Repository会从这个管理器里获取绑定的Session上下文。

正确的手动绑定示例（以Hibernate为例）：

@Autowired
private SessionFactory sessionFactory;
@Autowired
private YourRepository yourRepository;

Runnable manualSessionTask = () -> {
    Session session = null;
    try {
        session = sessionFactory.openSession();
        // 将Session绑定到Spring的同步管理器
        TransactionSynchronizationManager.bindResource(sessionFactory, new SessionHolder(session));
        // 必须开启事务，否则Session无法执行查询
        session.beginTransaction();
        
        // 调用Repository方法
        var result = yourRepository.findById(1L);
        System.out.println("手动绑定Session查询结果：" + result);
        
        session.getTransaction().commit();
    } catch (Exception e) {
        if (session != null && session.getTransaction().isActive()) {
            session.getTransaction().rollback();
        }
        throw new RuntimeException("子线程查询失败", e);
    } finally {
        if (session != null) {
            // 必须解绑并关闭Session，否则会导致连接泄漏
            TransactionSynchronizationManager.unbindResource(sessionFactory);
            session.close();
        }
    }
};

new Thread(manualSessionTask).start();

3. 用线程池的话，要配置上下文传递 #

如果你的子线程是从线程池获取的（比如用ThreadPoolTaskExecutor），默认情况下线程池的线程不会继承主线程的Spring上下文。这时候需要给线程池配置任务装饰器，把主线程的Session、事务等上下文复制到子线程中：

@Bean
public ThreadPoolTaskExecutor taskExecutor() {
    ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
    executor.setCorePoolSize(5);
    executor.setMaxPoolSize(10);
    executor.setQueueCapacity(25);
    
    // 配置任务装饰器，传递Spring上下文
    executor.setTaskDecorator(runnable -> {
        // 获取主线程的资源上下文（包括Session、事务相关）
        Map<Object, Object> mainThreadResources = new HashMap<>(TransactionSynchronizationManager.getResourceMap());
        // 也可以传递请求上下文（如果需要的话）
        RequestAttributes requestAttr = RequestContextHolder.getRequestAttributes();
        
        return () -> {
            try {
                // 将主线程的上下文绑定到子线程
                mainThreadResources.forEach(TransactionSynchronizationManager::bindResource);
                RequestContextHolder.setRequestAttributes(requestAttr);
                
                // 执行任务
                runnable.run();
            } finally {
                // 清理子线程的上下文，避免泄漏
                TransactionSynchronizationManager.clearResourceMap();
                RequestContextHolder.resetRequestAttributes();
            }
        };
    });
    
    executor.initialize();
    return executor;
}

之后用这个线程池执行任务，子线程就能继承主线程的数据访问上下文了。

4. 排查数据库连接池是否耗尽 #

最后也可以排查下数据库连接池的状态：如果主线程占用了所有连接（比如maxPoolSize设置过小，或者主线程有长事务），子线程会因为拿不到数据库连接而一直阻塞。可以通过连接池的监控指标（比如HikariCP的HikariPool-1 - Pool stats日志）查看连接使用情况。

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