Vaadin Flow页面刷新后SpringVaadinSession频繁变更问题求助

问题描述 #

在Vaadin Flow应用中，浏览器每刷新2-3次就会生成新的SpringVaadinSession实例，导致存储在Session中的用户数据出现异常。刷新时打印的Session实例ID如下：

com.vaadin.flow.spring.SpringVaadinSession@18dd1208
com.vaadin.flow.spring.SpringVaadinSession@64a5964b
com.vaadin.flow.spring.SpringVaadinSession@64a5964b
com.vaadin.flow.spring.SpringVaadinSession@52e6e25c
com.vaadin.flow.spring.SpringVaadinSession@52e6e25c
com.vaadin.flow.spring.SpringVaadinSession@52e6e25c
com.vaadin.flow.spring.SpringVaadinSession@52e6e25c
com.vaadin.flow.spring.SpringVaadinSession@52e6e25c

已确认Session生命周期设置为30分钟，且在视图类上添加了@PreserveOnRefresh注解，但问题仍未解决。示例代码如下：

@Route("/app")
@PreserveOnRefresh
public class AppView extends AppLayout {
    VaadinSession session = VaadinSession.getCurrent();
    public AppView() {
        System.out.println(session);
    }
}

排查与解决方案 #

1. 修正VaadinSession获取时机 #

在类成员变量位置直接调用VaadinSession.getCurrent()，时机可能早于Session绑定到当前请求的阶段，导致获取到临时或未初始化的Session实例。建议在构造方法内或onAttach方法中获取Session：

@Route("/app")
@PreserveOnRefresh
public class AppView extends AppLayout {
    public AppView() {
        VaadinSession session = VaadinSession.getCurrent();
        System.out.println(session);
    }
}

或者使用onAttach生命周期方法：

@Override
protected void onAttach(AttachEvent attachEvent) {
    super.onAttach(attachEvent);
    VaadinSession session = VaadinSession.getCurrent();
    System.out.println(session);
}

2. 检查Session Cookie配置 #

浏览器无法正确保存Session Cookie是频繁创建新Session的常见原因，需验证：

• Cookie的Secure属性：HTTPS环境下需开启，HTTP环境下需关闭，避免浏览器拒绝保存Cookie
• Cookie的SameSite属性：建议设置为Lax或None（跨域场景），防止同域/跨域请求时Cookie不被携带
• 服务器Session Cookie名称：确认未被自定义为浏览器阻止的名称

3. 排查Spring Security或拦截器影响 #

若应用使用Spring Security，需检查：

• 登录逻辑是否强制销毁或替换了原有Session
• 自定义拦截器是否在请求处理前清空了Session相关数据
• CSRF配置是否干扰了Session的正常绑定流程

4. 验证@PreserveOnRefresh生效范围 #

@PreserveOnRefresh仅负责保留UI实例，不直接控制Session生命周期：

• 确认视图类未被错误标记为@UIScope以外的作用域（如@RequestScope），避免每次刷新重建UI
• 检查是否关闭了Vaadin心跳功能（vaadin.heartbeat.enabled=false），心跳停止可能导致服务器提前回收Session

5. 排查分布式Session存储问题 #

若使用Redis等分布式Session存储，需验证：

• Session序列化逻辑是否正常，避免因序列化失败导致Session无法读取而重建
• 存储服务器连接是否稳定，防止Session丢失后触发新Session创建

内容的提问来源于stack exchange，提问作者Ronoo