Vaadin 21升级后Grid选择失效、Fusion视图权限报错问题咨询

异常原因分析 #

• Grid组件选中检测失效问题
  Vaadin 21对Grid的选择模型默认配置做了调整，默认开启了服务端惰性加载适配的选择状态缓存机制，如果你的Client实体类没有正确实现equals()和hashCode()方法，或者使用了非ID作为Grid的项标识，就会导致选择变化事件无法被正确识别。另外Vaadin 21修正了旧版本中选择事件冒泡的漏洞，如果你之前绑定选择事件用的addSelectionListener旧写法依赖了漏洞逻辑，也会出现失效问题。
• Fusion视图访问权限报错问题
  Vaadin 21对Fusion的端点和视图安全校验逻辑做了升级，默认开启了CSRF令牌强制校验，同时Spring Security的默认过滤链会新增对Fusion/connect端点和视图路径的拦截规则，如果你之前的Security配置只适配了Vaadin 20的白名单规则，没有新增Vaadin 21要求的Fusion相关路径放行规则、也没有配置前端CSRF令牌同步逻辑，就会触发非法访问错误。

修复方案建议 #

• Grid选择问题修复：给Client实体类补全基于业务主键的equals()和hashCode()实现，或者显式给Grid设置项标识grid.setItems(DataProvider.ofCollection(clientList).withIdentifier(Client::getId))；如果使用多选模式，可先显式指定选择模型grid.setSelectionMode(SelectionMode.MULTI)再绑定监听事件。
• Spring Security权限问题修复：在Security配置类的过滤链白名单中新增Fusion相关路径/connect/**、/vaadin-fusion/**，同时同步Vaadin Fusion的CSRF配置，在application.properties中添加vaadin.fusion.csrf.enabled=true，如果是无状态接口可根据业务需要调整为false。

版本回退建议 #

如果你的项目交付时间紧张，短时间内无法完成上述适配修改，也不需要使用Vaadin 21的新特性，可以暂时退回Vaadin 20.0.3版本，该版本稳定性已经过长期验证，和你现有教程、Kotlin/VoK生态的适配性更好。如果需要使用Vaadin 21的新功能（比如端到端类型安全、新增UI组件），按照上述方案完成适配即可，官方CRM教程已经适配说明核心功能没有严重缺陷，普通业务场景可以正常使用，Flow官方教程未更新仅为文档同步滞后，不是版本本身存在不可用的重大问题。

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