如何避免Wicket 9抛出StalePageException异常
避免Wicket StalePageException的可行方案
StalePageException的触发核心是Wicket默认会为每个页面维护多版本记录,每次Ajax操作更新页面状态后,页面版本号会递增,复制得到的旧页面携带的是过期版本号,后端匹配不到对应版本就会抛出异常,可通过以下任意一种方案解决:
- 禁用单页面版本管理:在对应页面的构造方法中添加代码
setVersioned(false),设置后该页面永远仅保留一个最新版本,无论执行多少次Ajax操作都不会生成新版本号,旧页面提交的请求也能正常匹配。该方案改动最小,适合大部分不需要页面多版本回退能力的业务场景。 - 全局调整页面版本保留数量:在Wicket应用的Application初始化类中添加配置
getPageSettings().setPagesPerSession(30),将单会话保留的页面版本数从默认的5调整到更大的数值,可避免多开标签页、复制页面场景下旧版本被提前清理的问题。 - 使用无状态页面:如果业务场景允许页面无状态,可让页面类继承
StatelessPage而非普通Page类,无状态页面完全不依赖服务端的版本缓存机制,自然不会触发该异常。 - 全局捕获异常做降级处理:自定义
IRequestCycleListener实现类,在onException回调中捕获StalePageException,直接重定向到当前页面的最新版本,或返回友好提示引导用户刷新,避免异常直接透传给用户。
注意:如果业务需要支持浏览器回退到历史页面状态并正常交互,不建议使用禁用页面版本的方案,可优先选择调整版本保留数或异常捕获降级的方案。
内容的提问来源于stack exchange,提问作者Rajani Sohoni
相关产品推荐
相关产品推荐

