Vaadin 23.2用@PreserveOnRefresh抛IllegalStateException排查方向

在Vaadin 23.2中为主路由添加@PreserveOnRefresh注解后，抛出异常：

java.lang.IllegalStateException: Can't move a node from one state tree to another. If this is intentional, first remove the node from its current state tree by calling removeFromTree

未使用共享静态资源，依赖注入采用CDI扩展而非Spring，怀疑Dialog组件可能引发该问题，考虑是否替换为免费的ConfirmDialog。

完整堆栈信息：

java.lang.IllegalStateException: Can't move a node from one state tree to another. If this is intentional, first remove the node from its current state tree by calling removeFromTree
        at com.vaadin.flow.internal.StateNode.doSetTree(StateNode.java:739)
        at com.vaadin.flow.internal.StateNode.lambda$setTree$3(StateNode.java:380)
        at com.vaadin.flow.internal.StateNode.visitNodeTree(StateNode.java:688)
        at com.vaadin.flow.internal.StateNode.setTree(StateNode.java:380)
        at com.vaadin.flow.internal.StateNode.setParent(StateNode.java:274)
        at com.vaadin.flow.internal.nodefeature.NodeFeature.attachPotentialChild(NodeFeature.java:80)
        at com.vaadin.flow.internal.nodefeature.StateNodeNodeList.add(StateNodeNodeList.java:55)
        at com.vaadin.flow.internal.nodefeature.ElementChildrenList.add(ElementChildrenList.java:44)
        at com.vaadin.flow.dom.impl.AbstractNodeStateProvider.insertChild(AbstractNodeStateProvider.java:104)
        at com.vaadin.flow.dom.Node.insertChild(Node.java:386)
        at com.vaadin.flow.dom.Node.appendChild(Node.java:163)
        at com.vaadin.flow.dom.Node.appendChild(Node.java:147)
        at com.vaadin.flow.component.internal.JavaScriptBootstrapUI$JavaScriptUIInternalUpdater.updateRoot(JavaScriptBootstrapUI.java:422)
        at com.vaadin.flow.component.internal.UIInternals.showRouteTarget(UIInternals.java:764)
        at com.vaadin.flow.router.internal.AbstractNavigationStateRenderer.handle(AbstractNavigationStateRenderer.java:222)
        at com.vaadin.flow.component.internal.JavaScriptNavigationStateRenderer.handle(JavaScriptNavigationStateRenderer.java:78)
        at com.vaadin.flow.router.internal.AbstractNavigationStateRenderer.lambda$getPreservedChain$cdbeaece$1(AbstractNavigationStateRenderer.java:778)
        at com.vaadin.flow.component.page.Page.lambda$retrieveExtendedClientDetails$fc941a8c$1(Page.java:576)
        at com.vaadin.flow.component.internal.PendingJavaScriptInvocation.complete(PendingJavaScriptInvocation.java:96)
        at com.vaadin.flow.server.communication.UidlWriter.lambda$createReturnValueChannel$d9004ac5$1(UidlWriter.java:316)
        at com.vaadin.flow.internal.nodefeature.ReturnChannelMap.lambda$registerChannel$2a20409b$1(ReturnChannelMap.java:124)
        at com.vaadin.flow.internal.nodefeature.ReturnChannelMap$ChannelImpl.invoke(ReturnChannelMap.java:74)
        at com.vaadin.flow.server.communication.ReturnChannelHandler.handleNode(ReturnChannelHandler.java:78)
        at com.vaadin.flow.server.communication.rpc.AbstractRpcInvocationHandler.handle(AbstractRpcInvocationHandler.java:75)
        at com.vaadin.flow.server.communication.ServerRpcHandler.handleInvocationData(ServerRpcHandler.java:438)
        at com.vaadin.flow.server.communication.ServerRpcHandler.lambda$handleInvocations$1(ServerRpcHandler.java:419)
        at java.base/java.util.ArrayList.forEach(ArrayList.java:1540)
        at com.vaadin.flow.server.communication.ServerRpcHandler.handleInvocations(ServerRpcHandler.java:419)
        at com.vaadin.flow.server.communication.ServerRpcHandler.handleRpc(ServerRpcHandler.java:320)
        at com.vaadin.flow.server.communication.UidlRequestHandler.synchronizedHandleRequest(UidlRequestHandler.java:115)
        at com.vaadin.flow.server.SynchronizedRequestHandler.handleRequest(SynchronizedRequestHandler.java:40)
        at com.vaadin.flow.server.VaadinService.handleRequest(VaadinService.java:1564)
        at com.vaadin.flow.server.VaadinServlet.service(VaadinServlet.java:364)
        at com.vaadin.cdi.CdiVaadinServlet.service(CdiVaadinServlet.java:67)
        at javax.servlet.http.HttpServlet.service(HttpServlet.java:733)
        at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:231)
        at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
        at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:53)
        at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
        at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
        at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:202)
        at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:97)
        at org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:542)
        at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:143)
        at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:92)
        at org.apache.catalina.valves.AbstractAccessLogValve.invoke(AbstractAccessLogValve.java:690)
        at org.apache.catalina.valves.rewrite.RewriteValve.invoke(RewriteValve.java:289)
        at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:78)
        at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:343)
        at org.apache.coyote.http11.Http11Processor.service(Http11Processor.java:374)
        at org.apache.coyote.AbstractProcessorLight.process(AbstractProcessorLight.java:65)
        at org.apache.coyote.AbstractProtocol$ConnectionHandler.process(AbstractProtocol.java:888)
        at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1597)
        at org.apache.tomcat.util.net.SocketProcessorBase.run(SocketProcessorBase.java:49)
        at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1128)
        at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628)
        at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)
        at java.base/java.lang.Thread.run(Thread.java:834)
16:21:58.739 [https-jsse-nio-443-exec-13] DEBUG c.v.f.s.communication.UidlWriter - * Creating response to client
16:21:58.740 [https-jsse-nio-443-exec-13] DEBUG com.vaadin.flow.server.VaadinService - Removing closed UI 1

排查方向 #

• 检查组件作用域：CDI环境下，若路由组件或其依赖的UI组件被标记为@ApplicationScoped/@SessionScoped，刷新时会复用实例，但Vaadin组件属于特定UI的状态树，跨UI复用会触发异常。确保相关组件使用@UIScoped或@Dependent作用域。
• Dialog组件的实例管理：若使用Dialog，检查是否存在全局实例（静态变量或CDI全局作用域实例）。刷新后新UI尝试复用旧Dialog，而旧Dialog已属于旧UI状态树。解决方式：每次使用时创建新实例，或在UI销毁/刷新前调用removeFromTree()清理旧实例，再重新初始化。ConfirmDialog设计为单次使用，无长期引用，可替换验证。
• PreserveOnRefresh的组件链检查：@PreserveOnRefresh保留路由组件实例，但刷新时UI重建。检查路由组件内部是否有子组件被意外共享（如CDI注入的非UI作用域组件包含Vaadin元素），确保所有UI组件绑定到当前UI实例。
• UI销毁时的资源清理：为UI添加销毁监听器，在UI.close()事件中手动清理Dialog、弹窗等组件引用，调用removeFromTree()将其从旧状态树移除，避免被新UI引用。
• 自定义组件的状态管理：若有自定义组件，确认内部是否缓存了Element或StateNode未释放。刷新时这些缓存节点属于旧UI，被新UI引用会触发异常，需清理缓存或在UI切换时重新初始化。
• CDI服务的组件隔离：检查CDI服务类是否持有Vaadin组件实例（如缓存Dialog），服务类应仅处理业务逻辑，UI组件实例由路由组件在UI作用域内创建，避免跨UI共享。

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