Vaadin捕获路由导航失败并重定向至已有路由的实现方法

方法一：自定义路由NotFound视图（推荐） #

Vaadin允许通过实现RouteNotFoundError接口替换默认404提示页，在自定义视图中直接执行重定向逻辑：

1. 创建实现RouteNotFoundError和BeforeEnterObserver的处理类：

import com.vaadin.flow.component.Component;
import com.vaadin.flow.component.Tag;
import com.vaadin.flow.router.BeforeEnterEvent;
import com.vaadin.flow.router.BeforeEnterObserver;
import com.vaadin.flow.router.RouteNotFoundError;

@Tag(Tag.DIV)
public class CustomNotFoundHandler extends Component implements RouteNotFoundError, BeforeEnterObserver {

    @Override
    public void beforeEnter(BeforeEnterEvent event) {
        // 重定向到指定路由，示例为login
        event.forwardTo("login");
        // 若需更新URL显示目标路由地址，改用：
        // event.rerouteTo("login");
    }
}

2. 确保该类处于Vaadin扫描范围内（放在应用包路径下即可），无需额外配置，访问未知URL时会自动触发重定向。

方法二：全局路由拦截（通过BeforeEnterListener） #

若需更灵活的全局路由校验，可添加全局监听器捕获路由不存在的情况：

1. 实现全局路由监听器：

import com.vaadin.flow.router.BeforeEnterEvent;
import com.vaadin.flow.router.BeforeEnterListener;
import com.vaadin.flow.router.NotFoundException;

public class AppRouteGuard implements BeforeEnterListener {

    @Override
    public void beforeEnter(BeforeEnterEvent event) {
        try {
            // 尝试解析当前路由，失败则抛出NotFoundException
            event.getNavigationTarget();
        } catch (NotFoundException e) {
            // 路由不存在时重定向到目标路由
            event.forwardTo("login");
        }
    }
}

2. 在UI初始化时注册监听器（例如主视图构造方法中）：

public MainView() {
    UI.getCurrent().addBeforeEnterListener(new AppRouteGuard());
}

注意事项 #

• forwardTo为服务器端转发，URL保持不变；rerouteTo为客户端重定向，URL会更新为目标路由地址，按需选择即可。
• 自定义处理逻辑会同时覆盖开发模式和生产环境的默认提示页。

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