Hazelcast缓存数据未显示：排查与解决指南_技术教程

本文旨在解决在使用Spring Cache结合Hazelcast时，通过@CachePut等注解成功将数据放入缓存，但无法通过HazelcastInstance获取缓存数据的问题。文章将深入探讨可能的原因，并提供详细的配置步骤和代码示例，帮助开发者正确配置和使用Hazelcast缓存。

在使用Spring Cache抽象层结合Hazelcast时，可能会遇到数据被成功缓存（例如，通过@CachePut注解），但无法通过HazelcastInstance直接访问缓存数据的情况。这通常是由于配置不当或对Spring Cache抽象层与Hazelcast集成理解不足造成的。下面我们将详细分析可能的原因以及相应的解决方案。

1. 确认是否启用了Spring的缓存抽象

首先，需要确保在Spring配置中显式启用了缓存抽象。这可以通过在配置类上添加@EnableCaching注解来实现。

import org.springframework.cache.annotation.EnableCaching;
import org.springframework.context.annotation.Configuration;

@Configuration
@EnableCaching
public class CachingConfig {
    // ...
}

如果使用的是Spring Boot，Spring Boot会自动配置缓存，但仍然建议显式添加@EnableCaching以确保缓存功能已启用。

2. 配置CacheManager Bean

除了启用缓存抽象外，还需要显式声明一个CacheManager Bean。对于Hazelcast，需要使用HazelcastCacheManager。

import com.hazelcast.core.HazelcastInstance;
import com.hazelcast.spring.cache.HazelcastCacheManager;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class HazelcastCacheConfig {

    @Bean
    public HazelcastCacheManager cacheManager(HazelcastInstance hazelcastInstance) {
        return new HazelcastCacheManager(hazelcastInstance);
    }
}

注意: 确保引入com.hazelcast:hazelcast-spring依赖。


    com.hazelcast
    hazelcast-spring
    ${hazelcast.version}
    runtime

这个依赖是HazelcastCacheManager正常工作所必需的。

3. 区分HazelcastCacheManager的不同实现

需要注意的是，com.hazelcast.spring.cache.HazelcastCacheManager (Spring Cache Abstraction的CacheManager实现) 和 com.hazelcast.cache.HazelcastCacheManager (Hazelcast自身的CacheManager) 不是同一个类。前者用于Spring Cache抽象，后者用于Hazelcast自身的缓存机制。

4. 检查Hazelcast配置

Hazelcast的配置也至关重要。确保MapConfig配置正确，并且实例名称与代码中使用的名称一致。

import com.hazelcast.config.*;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class HazelcastConfig {

    @Bean
    public Config hazelcastConf() {
        Config c = new Config()
                .setInstanceName("hazelcast-instance")
                .addMapConfig(
                        new MapConfig()
                                .setName("testmap")
                                .setEvictionConfig(
                                        new EvictionConfig()
                                                .setEvictionPolicy(EvictionPolicy.LRU)
                                                .setMaxSizePolicy(MaxSizePolicy.PER_NODE)
                                                .setSize(1000)
                                )
                                .setTimeToLiveSeconds(500000)
                );
        c.getNetworkConfig().getRestApiConfig().setEnabled(true);
        c.getNetworkConfig().getRestApiConfig().enableGroups(RestEndpointGroup.DATA);
        return c;
    }
}

5. 使用JCache (可选)

除了Spring Cache抽象，还可以使用JCache (JSR-107) 作为缓存提供者。 Spring Framework本身就提供了对JCache的支持。如果使用Spring Boot，需要指定Hazelcast的JCache缓存提供者类型 (例如，Embedded或Client/Server)。

6. 调试技巧

如果问题仍然存在，可以尝试以下调试技巧：

Spring Boot Debug模式: 在Spring Boot中，可以通过添加命令行开关 --debug 或在 application.properties 中设置 debug=true 来启用Debug模式。这将显示Auto-configuration的输出，可以检查 CacheAutoConfiguration 是否被处理。
日志记录: 启用详细的日志记录，以便查看缓存操作的详细信息。