Hazelcast缓存数据添加后无法在Map中显示问题排查与解决_技术教程

本文旨在解决在使用Spring Cache注解（如 @CachePut）向Hazelcast缓存添加数据后，无法直接通过 HazelcastInstance 获取对应Map并查看数据的问题。文章将详细介绍问题可能的原因，并提供相应的解决方案，包括启用缓存、

配置 CacheManager 以及使用 JCache 等方法，帮助开发者正确配置和使用 Hazelcast 缓存。

在使用 Spring 的 @CachePut 或 @Cacheable 注解将数据添加到 Hazelcast 缓存时，有时会遇到数据成功添加到缓存，但无法通过 HazelcastInstance 获取对应的 Map 并查看数据的情况。这通常是由于配置不当或缺少必要的依赖所致。以下将详细介绍可能的原因和解决方法。

确保已启用缓存

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

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

@Configuration
@EnableCaching
public class CachingConfig {
    // ... 其他配置
}

如果使用的是 Spring Boot，可以利用其自动配置功能。Spring Boot 会自动检测到 Hazelcast 并尝试配置缓存。可以通过在启动命令中添加 --debug 参数或在 application.properties 文件中设置 debug=true 来查看自动配置的详细信息，确认 CacheAutoConfiguration 类是否被成功处理。

配置 CacheManager

如果未使用 Spring Boot，或者自动配置未能正确生效，则需要手动声明一个 CacheManager Bean。在使用 Hazelcast 作为缓存提供者时，应使用 HazelcastCacheManager。

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

@Configuration
public class CacheConfig {

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

注意： 确保添加了 com.hazelcast:hazelcast-spring 依赖到项目的 pom.xml 文件中。


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

重要提示： 不要混淆 Spring Cache Abstraction 的 HazelcastCacheManager (需要 hazelcast-spring JAR) 和 Hazelcast 自身的 HazelcastCacheManager。它们是不同的类，前者是 Spring 缓存抽象的一部分，后者是 Hazelcast 提供的缓存管理器。

使用 JCache (JSR-107)

另一种选择是使用 Hazelcast 作为 JCache (JSR-107) 缓存提供者。Spring Framework 提供了对 JCache 的支持。

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

@Configuration
@EnableCaching
public class CachingConfig {
    // 配置 JCache 相关信息，例如指定 Hazelcast 作为缓存提供者
}

使用 Spring Boot 时，需要指定 Hazelcast 的 JCache 缓存提供者类型（例如，嵌入式或客户端/服务器模式）。具体的配置方式可以参考 Spring Boot 的相关文档。

代码示例与注意事项

以下是一个使用 @CachePut 注解的示例：

import org.springframework.cache.annotation.CachePut;
import org.springframework.stereotype.Service;

@Service
public class MyService {

    @CachePut(value = "myCache", key = "#id")
    public String getData(String id) {
        // 模拟从数据库获取数据
        String data = "Data for ID: " + id;
        System.out.println("Fetching data from source for ID: " + id);
        return data;
    }
}

注意事项：