Hazelcast缓存数据未显示：问题排查与解决方案-java教程-PHP中文网

Hazelcast缓存数据未显示：问题排查与解决方案

聖光之護

发布： 2025-10-10 10:54:05

原创

728人浏览过

hazelcast缓存数据未显示：问题排查与解决方案

本文针对在使用Spring Cache结合Hazelcast时，通过@CachePut注解添加数据后，无法在Hazelcast Map中看到对应条目的问题，提供详细的排查步骤和解决方案。主要涵盖Spring Cache的启用、CacheManager的配置、Hazelcast依赖的引入，以及JCache的使用等多个方面，帮助开发者快速定位问题并解决。

在使用Spring Cache抽象层与Hazelcast集成时，可能会遇到数据通过@CachePut或@Cacheable注解添加到缓存，但却无法直接在Hazelcast的Map中查看到的问题。这通常是由于配置不当或缺少必要的依赖造成的。以下是一些常见的排查步骤和解决方案。

1. 确认Spring Cache已启用

首先，确保你的Spring应用已经显式地启用了缓存功能。这需要使用@EnableCaching注解。将此注解添加到你的配置类上，例如：

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

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

登录后复制

2. 检查CacheManager的配置

如果未使用Spring Boot，则需要显式声明一个CacheManager bean。对于Hazelcast，你需要使用HazelcastCacheManager。确保已经添加了com.hazelcast:hazelcast-spring依赖到你的项目中。

Maven依赖：

<dependency>
    <groupId>com.hazelcast</groupId>
    <artifactId>hazelcast-spring</artifactId>
    <version>${hazelcast.version}</version>
    <scope>runtime</scope>
</dependency>

登录后复制

配置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 CacheConfig {

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

登录后复制

注意： 不要混淆 com.hazelcast.spring.cache.HazelcastCacheManager (Spring Cache Abstraction CacheManager实现) 和 com.hazelcast.cache.HazelcastCacheManager。前者需要 hazelcast-spring JAR，是Spring Cache Abstraction所必需的。

3. 使用Spring Boot时的自动配置

如果使用Spring Boot，它会自动配置缓存。可以通过在启动命令中添加 --debug 参数，或在 application.properties 文件中设置 debug=true 来查看自动配置的输出。确保 CacheAutoConfiguration 类已被处理。

4. 使用JCache (JSR-107)

另一种选择是使用Hazelcast作为JCache的缓存提供者。Spring Framework和Spring Boot都支持JCache。当使用Spring Boot时，你需要指定Hazelcast的JCache缓存提供者类型（例如：嵌入式或客户端/服务器）。

AI建筑知识问答

用人工智能ChatGPT帮你解答所有建筑问题

查看详情

5. 代码示例与配置检查

以下是一个完整的示例，展示了如何使用Spring Boot和Hazelcast进行缓存：

pom.xml (Maven):

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-cache</artifactId>
    </dependency>
    <dependency>
        <groupId>com.hazelcast</groupId>
        <artifactId>hazelcast</artifactId>
    </dependency>
    <dependency>
        <groupId>com.hazelcast</groupId>
        <artifactId>hazelcast-spring</artifactId>
    </dependency>
    <!-- other dependencies -->
</dependencies>

登录后复制

application.properties:

spring.cache.type=hazelcast

登录后复制

Service层代码:

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

@Service
public class MyService {

    @Cacheable("myCache")
    public String getData(String key) {
        System.out.println("Fetching data for key: " + key);
        // Simulate fetching data from a database or external source
        return "Data for " + key;
    }
}

登录后复制

注意事项：