Spring/Hibernate多租户架构下LazyInitializationException问题排查

核心差异点 #

• getById 的特性：Spring Data JPA 的 getById 返回的是延迟加载代理对象，不会立即执行数据库查询，只有当访问代理的属性（比如接口序列化返回时）才会触发查询。
• 事务与Session的关系：没有 @Transactional 注解时，调用 getById 后Hibernate的Session（持久化上下文）会立即关闭；加了 @Transactional 时，Session会在整个方法执行期间保持打开。
• findById 与 getById 的区别：findById 会立即执行数据库查询，返回实际的实体对象（或 Optional），不需要依赖后续Session加载数据。

多租户场景下的表现 #

单租户场景下出现类似问题的本质原因一致，但多租户的Session与租户标识符绑定更紧密：Session关闭后，即使后续尝试获取Session，也可能因为租户上下文丢失，无法正确关联到对应租户的数据库连接，所以问题表现得更突出。

方案1：给业务方法添加事务注解 #

直接在 getUserForId_0 方法上添加 @Transactional，让Session在方法执行周期内保持打开，确保代理对象加载属性时能获取到Session：

@Transactional(readOnly = true) // 只读操作添加readOnly优化性能
public User getUserForId_0(Long id) {
    return userRepo.getById(id);
}

方案2：替换getById为findById #

将 userRepo.getById(id) 替换为 findById，直接获取实体对象，避免依赖延迟加载代理：

public User getUserForId_0(Long id) {
    return userRepo.findById(id)
        .orElseThrow(() -> new RuntimeException("User not found"));
}

方案3：配置Open Session In View（谨慎使用） #

如果大量接口存在类似问题，可以配置OSIV让Session在整个HTTP请求周期内保持打开。在Spring Boot的application.properties/application.yml中添加：

spring.jpa.open-in-view=true

注意：OSIV会延长数据库连接的占用时间，高并发场景下可能导致连接池耗尽、性能下降，仅建议在低并发场景或临时修复时使用。

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