Vaadin v24.3.8中静态HTML链接点击报错，刷新正常的问题排查

原因分析 #

Vaadin的Anchor组件默认会通过客户端路由系统处理点击事件，它会尝试将路径匹配到Vaadin应用中定义的路由（比如带@Route注解的视图）。而你的静态HTML页面路径不属于Vaadin的路由配置，因此触发导航错误。

当你刷新浏览器时，请求会直接发送到服务器，此时Spring Boot的静态资源映射规则生效，服务器正确返回help.html文件，所以页面能正常加载。

解决方法 #

只需要给Anchor组件添加router-ignore属性，告诉Vaadin不要拦截该链接的点击事件，让浏览器直接处理跳转即可：

Anchor help = new Anchor("help/help.html", "Help");
// 添加router-ignore属性，绕过Vaadin客户端路由
help.getElement().setAttribute("router-ignore", true);
addToNavBar(help);

如果你担心相对路径的层级问题，也可以使用绝对路径：

Anchor help = new Anchor("/help/help.html", "Help");
help.getElement().setAttribute("router-ignore", true);
addToNavBar(help);

额外说明 #

你的Spring Boot静态资源映射配置是有效的，因为刷新页面能正常访问help.html，无需修改。如果需要更灵活的路径匹配，可以将addResourceHandler("/help/*.*")改为addResourceHandler("/help/**")，这样能匹配/help/下的所有文件及子目录。

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