Documentation versions (currently viewingVaadin 23)
New Acceleration Kits: Observability Kit, SSO Kit, and Swing Kit. Read the blog post.

Custom Error Handling

Customizing the error views related to navigation between routes.

You can customize the error views related to navigation between different routes as described in the Router Exception Handling article.

For other unhandled runtime exceptions, an ErrorHandler class can be used to let users know that something went wrong. To do so, first create your custom ErrorHandler class, then use that class to override the default error handler.

For example, the following CustomErrorHandler class logs the error and displays a friendly notification to the user.

public class CustomErrorHandler implements ErrorHandler {

    private static final Logger logger = LoggerFactory.getLogger(CustomErrorHandler.class);

    public void error(ErrorEvent errorEvent) {
        logger.error("Something wrong happened", errorEvent.getThrowable());
        if(UI.getCurrent() != null) {
            UI.getCurrent().access(() -> {
      "An internal error has occurred." +
                        "Contact support for assistance.");

Then assign the custom error handler to the current user session:

VaadinSession.getCurrent().setErrorHandler(new CustomErrorHandler());

To apply the custom error handler to all user sessions, you can use a SessionInitListener, which receives an event each time a new VaadinSession is initialized. See the Session and UI Listeners article to learn how to create a SessionInitListener.