对于最新的稳定版本，请使用 Spring Boot 3.5.5！spring-doc.cadn.net.cn

榛铸

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

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

存在ClientConfig豆。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 会尝试配置嵌入式服务器。如果定义Configbean，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

默认情况下，@SpringAware在 Hazelcast 组件上支持。这ManagedContext可以通过声明HazelcastConfigCustomizer带有@Order高于零。

Spring Boot 还对 Hazelcast 有显式缓存支持。如果启用了缓存，则HazelcastInstance会自动包装在CacheManager实现。