Spring Boot 3(JDK17)迁移：Hazelcast WebFilter兼容问题与@EnableHazelcastHttpSession等效性咨询

问题根源 #

Spring Boot 3基于Jakarta EE 9规范，原javax.servlet包已全面替换为jakarta.servlet，你之前使用的Hazelcast WebFilter依赖旧的javax.servlet.Filter接口，因此在JDK17+环境下无法正常工作。

可行解决思路 #

1. 升级Hazelcast依赖到兼容版本 #

首先确保你的Hazelcast依赖适配Jakarta EE：

• 直接使用Spring Boot 3提供的spring-boot-starter-hazelcast starter，它会自动引入兼容的Hazelcast及Spring集成包
• 手动引入的话，选择hazelcast-spring 5.3及以上版本，该版本已完成Jakarta API迁移

2. 替换为Jakarta兼容的WebFilter #

如果偏好手动配置Filter而非注解方式，需使用Hazelcast适配Jakarta的WebFilter实现（5.3+版本中com.hazelcast.web.WebFilter已改用jakarta.servlet.Filter），配置示例如下：

@Bean
public FilterRegistrationBean<WebFilter> hazelcastWebFilter(HazelcastInstance hazelcastInstance) {
    FilterRegistrationBean<WebFilter> registrationBean = new FilterRegistrationBean<>();
    registrationBean.setFilter(new WebFilter());
    registrationBean.addUrlPatterns("/*");
    registrationBean.setInitParameters(Map.of(
        "instance-name", hazelcastInstance.getName(),
        "sticky-session", "false"
    ));
    registrationBean.setOrder(1);
    return registrationBean;
}

3. 使用@EnableHazelcastHttpSession实现等效效果 #

这个注解完全可以达到你原WebFilter的会话共享效果，且是Spring官方推荐的集成方式，核心行为一致：

• 同样基于Hazelcast分布式存储会话数据，支持多实例共享
• 可通过配置关闭sticky session，实现无粘性会话
• 会自动关联你已配置的HazelcastInstance Bean

配置步骤

1. 在配置类上添加注解：

@Configuration
@EnableHazelcastHttpSession
public class HazelcastSessionConfig {

    @Bean
    public HazelcastInstance hazelcastInstance() {
        // 你的Hazelcast实例配置
        return Hazelcast.newHazelcastInstance();
    }
}

2. 在配置文件中设置参数：

spring.session.store-type=hazelcast
spring.session.hazelcast.sticky-session=false
spring.session.hazelcast.instance-name=your-hazelcast-instance-name

与原WebFilter的差异

注解方式基于Spring Session抽象层实现，无需手动配置Filter，更贴合Spring生态，但底层会话存储的逻辑和原WebFilter完全一致，不会改变会话共享的核心行为。

验证方法 #

启动多个应用实例，模拟用户请求在实例间切换，检查会话数据是否一致；同时查看Hazelcast管理控制台，确认会话数据正确存储在分布式Map中。

内容的提问来源于stack exchange，提问作者Alejandro Garcia Marchena