Spring Boot中Hibernate集成Redis二级缓存后查询仍走数据库的求助

看起来你已经把Redis作为二级缓存的基础架子搭起来了，实体也成功写入Redis，但数据库还是被频繁查询，这通常是因为Hibernate二级缓存的核心开关或查询缓存配置没到位，我来给你一步步排查的建议：

1. 确认全局二级缓存开关已开启 #

首先检查你的配置文件里有没有开启二级缓存的全局开关，这是最容易遗漏的点：

spring.jpa.properties.hibernate.cache.use_second_level_cache=true

如果没有这个配置，Hibernate默认不会启用二级缓存，就算你的RegionFactory配置正确，缓存也不会生效。

2. 检查实体类的缓存注解配置 #

确保你的实体类上的@Cacheable注解配置正确，尤其是缓存并发策略：

@Entity
@Cacheable(value = "UserCache", usage = CacheConcurrencyStrategy.READ_WRITE)
public class User {
    // ... 实体字段
}

• usage指定缓存的并发策略，READ_WRITE是常用的读写缓存策略，能保证缓存和数据库的一致性；如果用NONSTRICT_READ_WRITE可能存在短暂的数据不一致，也可能导致Hibernate优先查DB。
• 要确保实体类实现Serializable接口，不然Redisson序列化时可能出问题，导致缓存无法被正确读取。

3. 针对JPQL/HQL查询开启查询缓存 #

如果你的查询是通过JPQL、HQL或者Spring Data JPA的自定义查询方法（不是findById这类主键查询），Hibernate默认不会用二级缓存，需要开启查询缓存：

第一步：添加查询缓存配置 #

spring.jpa.properties.hibernate.cache.use_query_cache=true

第二步：在查询方法上添加缓存注解 #

比如Spring Data JPA的Repository方法：

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    @QueryHints({@QueryHint(name = org.hibernate.annotations.QueryHints.CACHEABLE, value = "true")})
    List<User> findByUsername(String username);
}

这样自定义查询才会触发查询缓存，避免每次都查数据库。

4. 开启Hibernate缓存日志验证命中情况 #

你可以打开Hibernate的缓存日志，直接观察缓存是否被命中：

logging.level.org.hibernate.cache=TRACE
logging.level.org.hibernate.SQL=DEBUG

启动应用后执行查询，如果日志里出现Cache hit的字样，说明缓存生效了；如果一直是Cache miss或者直接打印SQL，那就要回到前面的步骤检查配置。

5. 验证自定义RegionFactory的执行逻辑 #

你可以在createRedissonClient方法里加个日志或者断点，确认这个方法确实被调用了：

@Override
public RedissonClient createRedissonClient(Properties properties) {
    // 加日志验证
    System.out.println("Initializing Redisson Client for Hibernate Cache");
    Config config = new Config();
    config.useSingleServer().setAddress("redis://127.0.0.1:6379").setRetryInterval(1500)
          .setRetryAttempts(3).setConnectTimeout(10000)
          .setClientName("client1");
    return Redisson.create(config);
}

如果这个方法没被执行，说明你的RegionFactory配置可能有问题，比如package.CustomRegionFactory的包路径写错了。

6. 检查Redis中缓存数据的有效性 #

用redis-cli查看缓存的实体内容，确认序列化是否正确：

redis-cli get "your_entity_cache_key"

如果返回的内容是乱码或者不符合预期，可能是序列化问题，你可以尝试指定Redisson的序列化方式，比如用Kryo序列化：

config.setCodec(new KryoCodec());

不过默认的Jackson序列化只要实体类有正确的无参构造和字段访问权限，一般不会有问题。

按照这些步骤排查下来，应该就能找到为什么缓存写入了但没被读取的原因啦！

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