本文详解如何在 JVx 框架的 Vaadin UI 中精准控制会话生命周期：通过 closeIdleSessions=false 禁用空闲超时，结合 heartbeatInterval 维持活跃状态，实现“浏览器打开即有效、关闭即失效”的会话行为。
本文详解如何在 jvx 框架的 vaadin ui 中精准控制会话生命周期：通过 `closeidlesessions=false` 禁用空闲超时，结合 `heartbeatinterval` 维持活跃状态，实现“浏览器打开即有效、关闭即失效”的会话行为。
在 JVx 框架中集成 Vaadin UI 时，标准的 Servlet 容器级会话超时（如 web.xml 中的
关键在于区分两类超时机制：
- HTTP Session 超时（容器级）：由 web.xml 或 ServletContext 控制，影响底层会话存活，但不感知前端是否活跃；
- Vaadin 应用连接超时（框架级）：由 VaadinServlet 初始化参数驱动，可精细控制客户端保活逻辑。
✅ 正确配置方式是在 web.xml 中为 VaadinServlet 添加如下初始化参数：
<servlet><servlet-name>VaadinUI</servlet-name><servlet-class>com.sibvisions.rad.ui.vaadin.server.VaadinServlet</servlet-class><!-- 启用长连接保活：每50秒发送一次心跳请求 --><init-param><param-name>heartbeatInterval</param-name><param-value>50</param-value></init-param><!-- 关键！禁用空闲会话自动关闭，使会话仅随浏览器关闭而终止 --><init-param><param-name>closeIdleSessions</param-name><param-value>false</param-value></init-param><!-- 可选：设置应用层连接超时（单位：秒），避免应用先于 HTTP Session 失效 --><init-param><param-name>Application.connection.timeout</param-name><param-value>120</param-value></init-param><!-- 可选：推送轮询间隔（毫秒），缓解负载均衡器 WebSocket 断连问题 --><init-param><param-name>push.pollingInterval</param-name><param-value>14000</param-value></init-param></servlet>
? 核心参数说明：
- heartbeatInterval=50：客户端每 50 秒向服务端发起一次轻量心跳（/UIDL?... 请求），明确告知“应用仍在前台运行”，从而阻止框架判定为闲置；
- closeIdleSessions=false：必须设置为 false —— 此参数默认为 true，若启用将导致无操作超过 sessionTimeout 后强制销毁会话，违背“浏览器打开即有效”的设计目标；
- Application.connection.timeout=120：确保 JVx 应用连接超时短于容器 HTTP Session 超时（例如 web.xml 中设为 30 分钟），防止用户看到“已登录但应用不可用”的异常状态；
- push.pollingInterval=14000：在使用 WebSocket 不稳定环境（如 Nginx 默认 60s 超时）时，启用轮询兜底，避免连接静默断开。
⚠️ 注意事项：
- sessionTimeout 参数（单位：秒）在 Vaadin 7/8 中已被弃用，不应再使用；当前生效的是 heartbeatInterval + closeIdleSessions 组合；
- 浏览器关闭后，心跳停止，服务端将在下一个心跳周期（+ 少量延迟）内检测到连接丢失，并触发 VaadinSession.destroy() 和 Application.close()；
- 若部署于集群环境，需确保 HttpSession 复制或粘性会话（sticky session）已启用，否则心跳可能路由至错误节点导致误判；
- 建议配合前端监听页面可见性（document.visibilityState）和 beforeunload 事件，主动调用 window.location.reload() 或通知服务端预清理，提升响应一致性。
通过以上配置，即可实现真正以浏览器生命周期为边界的会话管理，兼顾用户体验与服务端资源效率。
