非Spring环境下Hibernate @TenantId多租户配置报错排查

你遇到的报错核心原因是Hibernate SessionFactory仅配置了租户标识符解析器，但缺少多租户模式的核心声明，同时需确保租户ID的获取逻辑不会返回空值。以下是具体需要补充的配置和检查点：

1. 声明行级多租户策略 #

在persistence.xml中添加多租户类型配置，明确指定使用行级区分策略：

<property name="hibernate.multiTenancy" value="DISCRIMINATOR"/>

这是Hibernate启用行级多租户的必要开关，没有该配置，SessionFactory无法识别你要使用的多租户模式，即便配置了CurrentTenantIdentifierResolver也会判定为未指定租户。

2. 确保租户ID获取逻辑无空值 #

检查TenantFilter.getTenantIdFromContext()的实现，必须保证它永远不会返回null或空字符串。对于未携带租户ID的场景（如公共访问请求），需设置默认租户ID兜底：

@Override
public String resolveCurrentTenantIdentifier() {
    String tenantId = TenantFilter.getTenantIdFromContext();
    // 兜底处理，避免返回空值触发报错
    return tenantId != null ? tenantId : "default_tenant";
}

3. 验证实体类的@TenantId注解 #

确保实体类中的tenant_id字段使用的是Hibernate原生的@TenantId注解（注意是org.hibernate.annotations.TenantId，而非Spring相关注解）：

import org.hibernate.annotations.TenantId;

@Entity
public class YourEntity {
    // 其他字段
    @TenantId
    private String tenantId;
    // getter/setter方法
}

若注解引用错误，Hibernate无法识别租户列，会间接导致租户ID未被正确应用。

4. 确认ThreadLocal的租户ID设置时机 #

确保TenantFilter（Tomcat过滤器）在请求进入业务逻辑前，已将租户ID存入ThreadLocal，且请求结束后清理ThreadLocal避免内存泄漏：

public class TenantFilter implements Filter {
    private static final ThreadLocal<String> TENANT_ID_CONTEXT = new ThreadLocal<>();

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        // 从请求头、参数或登录信息中提取租户ID
        String tenantId = extractTenantIdFromRequest(request);
        TENANT_ID_CONTEXT.set(tenantId);
        try {
            chain.doFilter(request, response);
        } finally {
            TENANT_ID_CONTEXT.remove();
        }
    }

    public static String getTenantIdFromContext() {
        return TENANT_ID_CONTEXT.get();
    }
}

若租户ID在Session创建后才被设置，Hibernate初始化Session时无法获取到租户ID，同样会触发该报错。

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