多租户环境下基于Infinispan的Hibernate二级实体缓存失效问题

问题根源 #

调用cache.evictEntityData时，Hibernate没有自动绑定当前租户ID，导致生成的缓存键缺失租户标识，和查询时的缓存键不匹配，所以失效操作无法命中目标缓存。

具体解决方案 #

1. 显式给Session设置租户ID再执行失效 #

这是最直接的处理方式，在调用缓存失效方法前，先为当前Session指定租户ID：

// 从EntityManager中获取原生Session
Session session = entityManager.unwrap(Session.class);
// 设置要操作的目标租户ID
session.setTenantIdentifier("target-tenant-id");
// 执行单个实体的缓存失效
session.getCache().evictEntityData(YourEntity.class, entityId);

这样Hibernate生成缓存键时会带上指定的租户ID，和查询时的缓存键完全匹配，就能正确命中并失效目标缓存。

2. 自定义租户感知的缓存键生成器 #

如果希望所有缓存操作自动处理租户ID，无需每次手动设置，可以自定义缓存键生成逻辑：

• 实现CacheKeySource接口，在生成缓存键时强制加入当前租户ID（比如从ThreadLocal上下文获取）：

public class TenantCacheKeySource implements CacheKeySource {
    @Override
    public Object generateCacheKey(Object id, Type type, String entityName, SessionFactoryImplementor factory) {
        // 假设用ThreadLocal存储当前请求的租户ID
        String tenantId = TenantContextHolder.getCurrentTenantId();
        // 返回包含租户ID的自定义缓存键，需正确实现equals和hashCode方法
        return new TenantAwareCacheKey(id, type, entityName, tenantId, factory);
    }
}

• 在persistence.xml中配置该自定义类：

<property name="hibernate.cache.key_source" value="com.yourcompany.cache.TenantCacheKeySource"/>

配置后，无论是查询缓存写入还是失效操作，生成的缓存键都会包含租户ID，自然能保证键的一致性。

3. 按租户清空整个实体缓存区域 #

如果不需要精确失效单个实体，可直接清空该租户下对应实体的所有缓存数据：

Session session = entityManager.unwrap(Session.class);
session.setTenantIdentifier("target-tenant-id");
session.getCache().evictEntityRegion(YourEntity.class);

这种方式适合批量更新后需要清空整个实体缓存的场景，操作简单高效。

验证要点 #

• 调试时确认Session的租户ID已正确设置，查看生成的缓存键是否包含租户标识。
• 确保实体类的@Cache注解配置正确，比如@Cache(usage = CacheConcurrencyStrategy.READ_WRITE)，保证多租户缓存隔离机制生效。

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