如需获取最新稳定版本，请使用 Spring Boot 4.0.4！spring-doc.cadn.net.cn

Hazelcast

如果 Hazelcast 在类路径上且找到了合适的配置，Spring Boot 会自动配置一个 HazelcastInstance，您可以将其注入到应用程序中。spring-doc.cadn.net.cn

Spring Boot 首先通过检查以下配置选项来尝试创建客户端：spring-doc.cadn.net.cn

存在一个 ClientConfig bean。spring-doc.cadn.net.cn
由 spring.hazelcast.config 属性定义的配置文件。spring-doc.cadn.net.cn
存在 hazelcast.client.config 系统属性。spring-doc.cadn.net.cn
工作目录或类路径根目录下的 hazelcast-client.xml。spring-doc.cadn.net.cn
工作目录或类路径根目录下的 hazelcast-client.yaml（或 hazelcast-client.yml）。spring-doc.cadn.net.cn

如果无法创建客户端，Spring Boot 会尝试配置一个嵌入式服务器。如果你定义了一个 Config bean，Spring Boot 将原样使用它。如果你的配置定义了一个实例名称，Spring Boot 会尝试定位现有的实例，而不是创建一个新的实例。spring-doc.cadn.net.cn

您也可以通过配置指定要使用的 Hazelcast 配置文件，如下例所示：spring-doc.cadn.net.cn

Propertiesspring-doc.cadn.net.cn
YAMLspring-doc.cadn.net.cn

spring.hazelcast.config=classpath:config/my-hazelcast.xml

spring:
  hazelcast:
    config: "classpath:config/my-hazelcast.xml"

否则，Spring Boot 会尝试从默认位置查找 Hazelcast 配置：hazelcast.xml 在工作目录中或类路径的根目录下，或者在相同位置的 YAML 对应文件。我们还会检查是否设置了 hazelcast.config 系统属性。有关更多详细信息，请参阅 Hazelcast 文档。spring-doc.cadn.net.cn

默认情况下，Hazelcast 组件支持 @SpringAware。可以通过声明一个 ManagedContext 为大于零的 HazelcastConfigCustomizer bean 来覆盖 @Order。

Spring Boot 还为 Hazelcast 提供了明确的缓存支持。如果启用了缓存，HazelcastInstance 将自动被包装在 CacheManager 实现中。