如何用Vaadin错误视图替代Spring Boot白标错误页面？

我之前也碰到过一模一样的情况——明明给SpringNavigator配置了错误视图，输入无效URL时却还是弹出Spring Boot的白标页面。核心问题在于Spring Boot的默认错误处理优先级比Vaadin的路由逻辑更高，无效请求根本没走到Vaadin的导航流程里。下面是我验证过的最优解决方案：

步骤1：让所有请求都经过Vaadin Servlet #

首先得确保Vaadin能接管所有HTTP请求，包括那些不存在的URL。在application.properties里添加：

vaadin.url-mapping=/*

这样不管用户输入什么路径，请求都会先交给Vaadin Servlet处理，而不是直接触发Spring Boot的404逻辑。

步骤2：正确配置SpringNavigator的错误视图 #

确保你的错误视图是合法的VaadinView，并且正确注册到导航器：

1. 创建错误视图组件 #

@Route(value = "not-found") // 这个路由路径会在导航到错误视图时使用
public class NotFoundView extends VerticalLayout implements View {
    public NotFoundView() {
        setSizeFull();
        setAlignItems(Alignment.CENTER);
        setJustifyContentMode(JustifyContentMode.CENTER);
        
        add(new H1("😕 404 - 页面不存在"));
        Button homeBtn = new Button("返回首页", e -> UI.getCurrent().navigate(MainView.class));
        homeBtn.addThemeVariants(ButtonVariant.LUMO_PRIMARY);
        add(homeBtn);
    }
}

2. 配置SpringNavigator #

在配置类里注入SpringNavigator并设置错误视图：

@Configuration
public class NavigatorConfig {

    @Autowired
    public void setupNavigator(SpringNavigator navigator, ViewProvider viewProvider) {
        // 设置错误视图，当找不到对应路由时自动跳转
        navigator.setErrorView(NotFoundView.class);
        // 添加Spring视图提供者，确保能扫描到所有@Route注解的视图
        navigator.addProvider(viewProvider);
    }
}

步骤3：（可选）兜底配置：禁用Spring Boot白标错误页面 #

如果上面两步做完还是偶尔出现白标页面，可以通过配置彻底禁用Spring Boot的默认错误处理，强制让所有错误请求走Vaadin的逻辑：

server.error.whitelabel.enabled=false

另外，还可以自定义ErrorController来精准转发404请求到Vaadin的错误视图（适合需要处理多种错误码的场景）：

@Controller
public class CustomErrorController implements ErrorController {

    private static final String ERROR_PATH = "/error";

    @RequestMapping(ERROR_PATH)
    public String handleError(HttpServletRequest request) {
        Integer statusCode = (Integer) request.getAttribute(RequestDispatcher.ERROR_STATUS_CODE);
        if (statusCode != null && statusCode == HttpStatus.NOT_FOUND.value()) {
            // 转发到Vaadin的错误路由
            return "forward:/not-found";
        }
        // 其他错误可以跳转到对应的Vaadin视图或返回首页
        return "forward:/";
    }

    @Override
    public String getErrorPath() {
        return ERROR_PATH;
    }
}

这样配置后，不管用户输入什么无效URL，都会被Vaadin接管并展示你自定义的Vaadin组件错误页面，完全替代Spring Boot的白标页面。

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