解决Spring Repository多租户场景下的could not initialize proxy - no session错误

针对你遇到的动态多租户独立Schema场景下的懒加载报错问题，按以下方向排查修复：

1. 确保租户上下文优先于Hibernate会话初始化 #

动态切换租户的核心是先设置租户ID，再创建Hibernate会话。如果会话已经创建后才切换租户，后续懒加载会找不到对应租户的有效会话：

• 检查你的租户拦截器/过滤器的执行顺序，必须在OpenSessionInViewFilter（或OpenEntityManagerInViewFilter）之前执行。比如在Spring Boot中设置过滤器优先级时，租户过滤器的order设为Ordered.HIGHEST_PRECEDENCE，OSIV过滤器设为次高优先级。

2. 启用Open Session In View（OSIV）过滤器 #

懒加载通常在事务结束后（比如控制器层返回DTO、序列化对象时）触发，此时服务层的事务已关闭，会话销毁。配置OSIV可以延长会话生命周期到请求结束：

@Configuration
public class WebConfig {
    @Bean
    public FilterRegistrationBean<OpenEntityManagerInViewFilter> openEntityManagerInViewFilter() {
        FilterRegistrationBean<OpenEntityManagerInViewFilter> registrationBean = new FilterRegistrationBean<>();
        registrationBean.setFilter(new OpenEntityManagerInViewFilter());
        // 优先级低于租户过滤器，确保先设置租户再创建会话
        registrationBean.setOrder(Ordered.HIGHEST_PRECEDENCE + 1);
        return registrationBean;
    }
}

如果使用Hibernate原生API，替换为OpenSessionInViewFilter即可。

3. 校验事务注解的有效性 #

• 确认@Transactional注解的方法是通过Spring代理调用的：避免在同一个类内部直接调用带注解的方法（此时代理不生效，事务不会开启）。
• 检查事务的传播行为：默认的REQUIRED可以保证调用链中事务上下文的延续，确保懒加载操作在事务范围内执行。如果是多层服务调用，建议在顶层入口方法添加@Transactional。

4. 保证租户上下文的线程安全性 #

租户ID通常存在ThreadLocal中，要在请求结束后清理，防止线程池复用导致的租户信息混乱：

public class TenantFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        try {
            // 从请求中获取租户ID并设置到ThreadLocal
            String tenantId = ((HttpServletRequest) request).getHeader("X-Tenant-ID");
            TenantContext.setTenantId(tenantId);
            chain.doFilter(request, response);
        } finally {
            // 必须清理ThreadLocal，避免线程复用问题
            TenantContext.clear();
        }
    }
}

5. 检查Hibernate多租户配置正确性 #

确认多租户核心组件的实现无问题：

• CurrentTenantIdentifierResolver：必须正确从ThreadLocal获取当前租户ID，且Hibernate能在会话创建时调用它。
• MultiTenantConnectionProvider：确保能根据租户ID切换到对应的Schema。
• 配置文件中开启多租户支持：

spring.jpa.hibernate.multiTenancy=SCHEMA
spring.jpa.hibernate.tenant_identifier_resolver=com.amran.dynamic.multitenant.tenant.resolver.TenantIdentifierResolver
spring.jpa.hibernate.multi_tenant_connection_provider=com.amran.dynamic.multitenant.tenant.provider.MultiTenantConnectionProviderImpl

针对你提到的ProductServiceImpl第26行报错，大概率是在事务结束后才访问Tenant的懒加载属性（比如服务方法返回后，在控制器层序列化时触发），此时会话已关闭。启用OSIV过滤器可以解决这类场景的问题。

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