fix: log Vite build failure only once instead of on every request (#24085) (CP: 25.1) (#24088)

This PR cherry-picks changes from the original PR #24085 to branch 25.1.
---
#### Original PR description
> When the Vite dev server fails to start, the exception was re-thrown
on every subsequent HTTP request, flooding the log with identical stack
traces. Now the error is thrown once and subsequent requests gets the
error in the browser instead.

Co-authored-by: Artur Signell <artur@vaadin.com>

Author: vaadin-bot

flow-build-tools/src/main/java/com/vaadin/flow/server/frontend/TaskRunDevBundleBuild.java

@@ -208,11 +208,12 @@ private void runFrontendBuildTool(String toolName, String packageName,
             int errorCode = process.waitFor();
 
             if (errorCode != 0) {
-                logger.error("Command `{}` failed:\n{}", commandString,
-                        toolOutput);
-                throw new ExecutionFailedException(
+                ExecutionFailedException exception = new ExecutionFailedException(
                         SharedUtil.capitalize(toolName)
-                                + " build exited with a non zero status");
+                                + " build exited with a non zero status:\n"
+                                + toolOutput);
+                logger.error("Command `{}` failed", commandString, exception);
+                throw exception;
             } else {
                 logger.info("Development frontend bundle built");
             }

vaadin-dev-server/src/main/java/com/vaadin/base/devserver/AbstractDevServerRunner.java

@@ -34,7 +34,6 @@
 import java.util.UUID;
 import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.CompletionException;
-import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.concurrent.atomic.AtomicReference;
 import java.util.function.BiConsumer;
 import java.util.regex.Pattern;
@@ -107,7 +106,7 @@ public abstract class AbstractDevServerRunner implements DevModeHandler {
     private final boolean reuseDevServer;
     private final File devServerPortFile;
 
-    private AtomicBoolean isDevServerFailedToStart = new AtomicBoolean();
+    private AtomicReference<String> devServerFailure = new AtomicReference<>();
 
     private final CompletableFuture<Void> devServerStartFuture;
 
@@ -217,8 +216,11 @@ void doStartDevModeServer() throws ExecutionFailedException {
             Process process = doStartDevServer();
             devServerProcess.set(process);
             if (!isRunning()) {
-                throw new IllegalStateException("Startup of " + getServerName()
-                        + " failed. Output was:\n" + getFailedOutput());
+                IllegalStateException exception = new IllegalStateException(
+                        "Startup of " + getServerName()
+                                + " failed. Output was:\n" + getFailedOutput());
+                getLogger().error("Dev server failed to start", exception);
+                throw exception;
             }
 
             long ms = (System.nanoTime() - start) / 1000000;
@@ -648,22 +650,30 @@ public HttpURLConnection prepareConnection(String path, String method)
     public boolean handleRequest(VaadinSession session, VaadinRequest request,
             VaadinResponse response) throws IOException {
         return handleRequestInternal(session, request, response,
-                devServerStartFuture, isDevServerFailedToStart);
+                devServerStartFuture, devServerFailure);
     }
 
     static boolean handleRequestInternal(VaadinSession session,
             VaadinRequest request, VaadinResponse response,
             CompletableFuture<?> devServerStartFuture,
-            AtomicBoolean isDevServerFailedToStart) throws IOException {
-        if (devServerStartFuture.isDone()) {
-            // The server has started, check for any exceptions in the startup
-            // process
+            AtomicReference<String> devServerFailure) throws IOException {
+        if (devServerFailure.get() == null && devServerStartFuture.isDone()) {
             try {
                 devServerStartFuture.getNow(null);
             } catch (CompletionException exception) {
-                isDevServerFailedToStart.set(true);
-                throw getCause(exception);
+                RuntimeException cause = getCause(exception);
+                devServerFailure.set("The Vite dev server failed to start: "
+                        + cause.getMessage());
             }
+        }
+        String failureMessage = devServerFailure.get();
+        if (failureMessage != null) {
+            response.setContentType("text/html;charset=utf-8");
+            response.setHeader("Cache-Control", "no-cache");
+            response.getWriter().write("<pre>" + failureMessage + "</pre>");
+            return true;
+        }
+        if (devServerStartFuture.isDone()) {
             if (request.getHeader("X-DevModePoll") != null) {
                 // Avoid creating a UI that is thrown away for polling requests
                 response.setContentType("text/html;charset=utf-8");
@@ -721,7 +731,7 @@ static boolean handleRequestInternal(VaadinSession session,
     public boolean serveDevModeRequest(HttpServletRequest request,
             HttpServletResponse response) throws IOException {
         // Do not serve requests if dev server starting or failed to start.
-        if (isDevServerFailedToStart.get() || !devServerStartFuture.isDone()
+        if (devServerFailure.get() != null || !devServerStartFuture.isDone()
                 || devServerStartFuture.isCompletedExceptionally()) {
             return false;
         }

vaadin-dev-server/src/main/java/com/vaadin/base/devserver/DevBundleBuildingHandler.java

@@ -22,7 +22,7 @@
 import java.io.IOException;
 import java.net.HttpURLConnection;
 import java.util.concurrent.CompletableFuture;
-import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.concurrent.atomic.AtomicReference;
 
 import com.vaadin.flow.internal.DevModeHandler;
 import com.vaadin.flow.server.VaadinRequest;
@@ -45,6 +45,7 @@
 public final class DevBundleBuildingHandler implements DevModeHandler {
 
     private final transient CompletableFuture<Void> buildCompletedFuture;
+    private final AtomicReference<String> devServerFailure = new AtomicReference<>();
 
     public DevBundleBuildingHandler(
             CompletableFuture<Void> buildCompletedFuture) {
@@ -91,7 +92,7 @@ public int getPort() {
     public boolean handleRequest(VaadinSession session, VaadinRequest request,
             VaadinResponse response) throws IOException {
         return AbstractDevServerRunner.handleRequestInternal(session, request,
-                response, buildCompletedFuture, new AtomicBoolean());
+                response, buildCompletedFuture, devServerFailure);
     }
 
     /**

vaadin-dev-server/src/main/java/com/vaadin/base/devserver/startup/DevModeInitializer.java

@@ -68,7 +68,6 @@
 import com.vaadin.flow.server.Mode;
 import com.vaadin.flow.server.VaadinContext;
 import com.vaadin.flow.server.VaadinServlet;
-import com.vaadin.flow.server.frontend.ExecutionFailedException;
 import com.vaadin.flow.server.frontend.NodeTasks;
 import com.vaadin.flow.server.frontend.Options;
 import com.vaadin.flow.server.frontend.installer.NodeInstaller;
@@ -389,8 +388,8 @@ static Set<File> getFrontendLocationsFromResourceProvider(
     private static void runNodeTasks(NodeTasks tasks) {
         try {
             tasks.execute();
-        } catch (ExecutionFailedException exception) {
-            log().debug(
+        } catch (Exception exception) {
+            log().error(
                     "Could not initialize dev mode handler. One of the node tasks failed",
                     exception);
             throw new CompletionException(exception);