Vaadin 23集成Spring Session JDBC后页面持续重复刷新的问题排查与正确集成方法咨询

问题场景 #

我正在构建一个Vaadin 23 + Spring Boot 2.7的应用，尝试集成Spring Session JDBC来实现1分钟无操作后会话过期。但遇到了一个棘手的问题：启动应用后，浏览器（localhost:8080）会极速地持续刷新。如果注释掉Spring Session的依赖，应用就立刻恢复正常了。

我已经完成了以下配置步骤：

• 添加了spring-session-jdbc依赖
• 通过@EnableJdbcHttpSession(maxInactiveIntervalInSeconds = 60)启用JDBC会话存储
• 手动创建了所需的数据库表：SPRING_SESSION和SPRING_SESSION_ATTRIBUTES
• 验证数据库中已成功生成会话条目
• 配置了spring.session.store-type=jdbc和server.servlet.session.timeout=1m
• 临时降低了Spring Session的自动清理频率（调整为每30分钟执行一次）

相关代码片段 #

SessionConfig.java（会话配置类） #

import org.springframework.context.annotation.Configuration;
import org.springframework.session.jdbc.config.annotation.web.http.EnableJdbcHttpSession;

@Configuration
@EnableJdbcHttpSession(maxInactiveIntervalInSeconds = 60) // 临时设置为1分钟超时
public class SessionConfig {
}

application.properties（应用配置） #

# MySQL连接配置
spring.datasource.url=jdbc:mysql://localhost:3306/session
spring.datasource.username=root
spring.datasource.password=MyPassword

# Hibernate调优配置（可选）
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect

# 会话超时配置
server.servlet.session.timeout=1m

# 调整会话清理任务频率
spring.session.jdbc.cleanup-cron=0 */30 * * * * # 每30分钟执行一次

MainView.java（Vaadin主视图） #

import com.vaadin.flow.component.button.Button;
import com.vaadin.flow.component.grid.Grid;
import com.vaadin.flow.component.orderedlayout.VerticalLayout;
import com.vaadin.flow.component.textfield.TextField;
import com.vaadin.flow.router.Route;
import org.springframework.beans.factory.annotation.Autowired;
import com.vaadin.flow.component.UI;

@Route("")
public class MainView extends VerticalLayout {
    private final PersonRepository personRepository;
    private final Grid<Person> grid = new Grid<>(Person.class);

    public MainView(@Autowired PersonRepository personRepository) {
        UI.getCurrent().setPollInterval(10000); // 10秒一次前端轮询
        this.personRepository = personRepository;

        TextField firstNameField = new TextField("First Name");
        TextField lastNameField = new TextField("Last Name");
        Button addButton = new Button("Add", event -> {
            Person person = new Person(firstNameField.getValue(), lastNameField.getValue());
            personRepository.save(person);
            updateGrid();
            firstNameField.clear();
            lastNameField.clear();
        });

        add(firstNameField, lastNameField, addButton, grid);
        grid.setColumns("firstName", "lastName");
        updateGrid();
    }

    private void updateGrid() {
        grid.setItems(personRepository.findAll());
    }
}

核心疑问 #

为什么集成Spring Session后Vaadin页面会持续刷新？如何正确地将Spring Session JDBC与Vaadin 23集成？

问题根源分析与解决方案 #

可能的冲突点 #

Vaadin依赖稳定的会话上下文维护前后端连接，而Spring Session JDBC的外部会话存储可能从以下几个方面引发冲突：

1. 会话ID频繁重置：如果Spring Session在每次请求时生成新的会话ID（比如数据库表字段不兼容、序列化失败），Vaadin前端会因上下文失效触发刷新，进入循环。
2. 轮询与会话更新冲突：10秒的轮询请求如果没有正确更新会话的最后活跃时间，可能被Spring Session误判为无操作，或者会话更新时导致前端状态失效。
3. Vaadin会话属性序列化失败：Vaadin的会话对象如果无法序列化到JDBC存储，会导致会话更新失败，触发前端重试。

分步解决方案 #

1. 修复数据库会话表结构（关键）

确保SPRING_SESSION和SPRING_SESSION_ATTRIBUTES完全符合Spring Session MySQL规范，避免字段类型错误：

• SPRING_SESSION.SESSION_ID：VARCHAR(255)（必须足够长）
• SPRING_SESSION.EXPIRY_TIME：BIGINT（存储时间戳，而非DATETIME）
• SPRING_SESSION_ATTRIBUTES.ATTRIBUTE_BYTES：LONGBLOB（存储序列化的会话属性）
  建议直接使用Spring Session官方提供的MySQL建表脚本，避免手动创建的错误。

2. 配置Vaadin会话序列化策略

在application.properties中添加：

# 允许Vaadin会话属性使用Java序列化（适配无法实现Externalizable的对象）
vaadin.session.serialization.whitelist=*
# 或指定具体白名单类（更安全）
# vaadin.session.serialization.whitelist=com.yourpackage.Person,com.vaadin.flow.component.*

3. 调整轮询与会话超时逻辑

• 先临时移除UI.getCurrent().setPollInterval(10000)，测试是否还会刷新。如果问题消失，说明轮询与会话更新存在冲突：
  • 可将轮询时间调整为15秒（小于超时时间的1/3），确保轮询请求能正确更新会话活跃时间
  • 或启用Vaadin Push（长连接）替代轮询，减少请求次数

4. 禁用会话ID URL重写

Vaadin不依赖URL重写传递会话ID，在application.properties中添加：

spring.session.jdbc.http-session-id-rewrite-enabled=false

5. 统一会话超时配置

移除server.servlet.session.timeout，仅保留@EnableJdbcHttpSession中的配置，避免双重冲突：

@Configuration
@EnableJdbcHttpSession(maxInactiveIntervalInSeconds = 60)
public class SessionConfig {
}

6. 调试会话稳定性

添加会话监听器，观察会话ID是否稳定：

import org.springframework.stereotype.Component;
import javax.servlet.http.HttpSessionEvent;
import javax.servlet.http.HttpSessionListener;

@Component
public class SessionDebugListener implements HttpSessionListener {
    @Override
    public void sessionCreated(HttpSessionEvent se) {
        System.out.println("新会话创建: " + se.getSession().getId());
    }

    @Override
    public void sessionDestroyed(HttpSessionEvent se) {
        System.out.println("会话销毁: " + se.getSession().getId());
    }
}

如果控制台频繁打印“新会话创建”，说明会话在被频繁重置，需要排查数据库持久化逻辑。

验证步骤 #

1. 应用配置后启动，观察浏览器网络请求是否恢复正常
2. 检查数据库SPRING_SESSION表，确认会话ID稳定，LAST_ACCESS_TIME随操作/轮询更新
3. 等待1分钟无操作，验证会话是否正常过期且无异常刷新

内容来源于stack exchange