Spring Boot中@RequestScope实现Hibernate Schema多租户报错咨询

问题解答 #

1. @RequestScope代理相关问题 #

@RequestScope默认的代理模式为ScopedProxyMode.DEFAULT，无额外AOP配置时等价于ScopedProxyMode.NO，不会自动生成可注入单例Bean的代理，需要补充两个配置：

• 给UserContext显式指定代理模式：

@Component
@RequestScope(proxyMode = ScopedProxyMode.TARGET_CLASS)
public class UserContext {
    // 原有属性和方法
}

• 注册RequestContextListener暴露请求上下文，在配置类中添加Bean定义：

@Bean
public RequestContextListener requestContextListener() {
    return new RequestContextListener();
}

2. 启动阶段数据库连接问题 #

Hibernate初始化SessionFactory时，默认会主动获取JDBC连接读取数据库元数据、校验连接有效性，即使未配置hbm2ddl.auto也会触发该行为，该阶段无HTTP请求上下文，会导致租户解析失败。

完整解决方案 #

步骤1：优化租户解析逻辑，兼容非请求场景 #

修改CurrentTenant的解析方法，无请求上下文时返回公共默认Schema，避免空指针和异常：

@Override
public String resolveCurrentTenantIdentifier() {
    // 校验是否存在活跃请求上下文
    RequestAttributes requestAttr = RequestContextHolder.getRequestAttributes();
    if (requestAttr != null) {
        return Optional.ofNullable(userContext.getDomain())
                // 请求上下文存在但租户为空时返回默认Schema
                .orElse("public");
    }
    // 非请求场景（启动/异步线程）返回默认Schema
    return "public";
}

步骤2：关闭Hibernate启动阶段的JDBC元数据获取 #

在Hibernate配置中添加以下参数，禁止启动时主动连接数据库：

// 禁用JDBC元数据默认配置，避免启动阶段连接数据库
properties.put("hibernate.temp.use_jdbc_metadata_defaults", false);
// 配置连接延迟获取，仅在需要执行SQL时才获取连接
properties.put(AvailableSettings.CONNECTION_HANDLING, PhysicalConnectionHandlingMode.DELAYED_ACQUISITION_AND_HOLD);

步骤3：修复请求阶段租户解析时机错误问题 #

你遇到的请求进入Controller前就报表不存在的问题，是Spring默认开启的OpenEntityManagerInView机制导致的：该机制会在请求进入Controller前就打开EntityManager，此时你的UserContext还未完成填充（比如你是在自定义拦截器/Filter中填充租户信息），解析到的是默认Schema导致找不到表，两种解决方案二选一即可：

• 关闭OpenEntityManagerInView：在application.properties中添加配置spring.jpa.open-in-view=false，EntityManager会在第一次执行SQL时才初始化，此时租户信息已经填充完成
• 调整拦截器优先级：如果你需要保留OpenEntityManagerInView，将你填充UserContext的拦截器优先级设置为高于OpenEntityManagerInViewInterceptor，确保打开EntityManager前租户信息已写入UserContext

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