Vaadin 7同会话多UI操作阻塞问题排查及解决需求

Vaadin 7 默认对 VaadinSession 采用独占式锁机制——同一时刻只有一个线程能访问该 Session 下的任何 UI 实例。同一浏览器的多个标签页会共享同一个 Session（通过 Cookie 传递 Session ID），因此第二个标签页的请求会被 Session 锁阻塞，直到第一个请求执行完毕并释放锁。不同浏览器对应独立 Session，自然不存在阻塞问题。

要实现同一 Session 下多标签页并行操作，可通过调整 Session 锁策略或优化耗时逻辑的执行方式来解决：

1. 启用 Session 并行访问模式 #

Vaadin 7 支持将 Session 设置为并行访问模式，允许同一 Session 下的多个 UI 同时处理请求，但需保证 UI 自身的线程安全。

在自定义 SessionInitListener 中配置：

public class CustomSessionInitListener implements SessionInitListener {
    @Override
    public void sessionInit(SessionInitEvent event) throws ServiceException {
        VaadinSession session = event.getSession();
        // 开启并行访问锁策略
        session.getLockInstance().setLockStrategy(LockStrategy.PARALLEL);
    }
}

在 web.xml 中注册该监听器：

<listener>
    <listener-class>com.yourpackage.CustomSessionInitListener</listener-class>
</listener>

⚠️ 注意：启用并行模式后，必须确保所有 UI 相关操作（组件状态修改、数据绑定等）线程安全，避免并发修改引发的异常。

2. 将耗时操作移出 Session 锁范围 #

如果不想全局修改 Session 策略，可把刷新按钮触发的耗时逻辑（如数据库查询、复杂计算）放到 Session 锁之外执行，让 UI 快速释放锁，允许其他请求进入。

示例代码：

refreshButton.addClickListener(e -> {
    VaadinSession session = VaadinSession.getCurrent();
    // 先释放 Session 锁
    session.unlock();
    try {
        // 执行耗时的搜索逻辑（无 UI 操作）
        List<Data> result = dataService.search(searchCondition);
        // 重新获取锁，更新 UI 组件
        session.lock();
        grid.setItems(result);
    } finally {
        // 确保锁最终被释放
        if (session.hasLock()) {
            session.unlock();
        }
    }
});

这种方式无需全局修改，仅针对特定耗时操作优化，线程安全风险更低。

3. 确保 UI 操作的线程安全 #

无论采用哪种方案，都要保证 UI 组件的修改仅在持有 Session 锁的线程中进行。并行模式下，若多个线程同时修改同一 UI 组件，会导致不可预期的状态异常：

• 避免在 UI 实例中存储可变的非线程安全状态
• 所有 UI 更新操作需通过 access() 方法或在持有锁的线程中执行：

// 异步操作完成后安全更新 UI
UI.getCurrent().access(() -> {
    grid.setItems(result);
});

优先选择第二种方案（移出耗时操作），实现成本低且风险可控；若需全局支持多 UI 并行，再启用并行锁模式，同时严格保障 UI 线程安全。

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