Build failing: incompatible npm version (9.2.0) with Vaadin 24.x

[javier-godoy]

The Google Maps Add-on build is failing during the prepare-frontend phase due to npm 9.2.0 being flagged as incompatible by Vaadin's version checker.

Reported by: Vaadin Ecosystem Build
Build log: https://ecosystembuild.parttio.org/logs/24.9-SNAPSHOT/Google%20Maps%20Add-on-build.log

Error

The Vaadin Maven plugin rejects npm 9.2.0 as a problematic version during prepare-frontend. This causes the build to fail before any compilation occurs.

Notes

• The build fails against Vaadin 24.9-SNAPSHOT (tested by the ecosystem build)
• The build also fails with the project's own configured Vaadin version (24.2.6 via the v24 profile), so this is not exclusively a snapshot compatibility issue

Possible fixes

1. Upgrade npm globally: npm install -g npm@latest
2. Configure frontend-maven-plugin to install a compatible Node/npm version:

   mvn com.github.eirslett:frontend-maven-plugin:1.10.0:install-node-and-npm -DnodeVersion="v20.9.0"
   

3. Add -Dvaadin.ignoreVersionChecks=true to bypass the check (not recommended for production)

[javier-godoy]

Build log

From https://github.com/FlowingCode/GoogleMapsAddon
 * branch            master     -> FETCH_HEAD
Already on 'master'
Your branch is up to date with 'origin/master'.
HEAD is now at 813373b ci(demo): upgrade commons-demo to 5.2.0 in v25 profile
[INFO] Scanning for projects...
[INFO] 
[INFO] -------------< com.flowingcode.vaadin.addons:google-maps >--------------
[INFO] Building Google Maps Addon 2.4.1-SNAPSHOT
[INFO]   from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] 
[INFO] --- versions:2.21.0:set-property (default-cli) @ google-maps ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.069 s
[INFO] Finished at: 2026-03-18T05:38:10Z
[INFO] ------------------------------------------------------------------------
[INFO] Scanning for projects...
[INFO] 
[INFO] -------------< com.flowingcode.vaadin.addons:google-maps >--------------
[INFO] Building Google Maps Addon 2.4.1-SNAPSHOT
[INFO]   from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] 
[INFO] --- versions:2.21.0:set (default-cli) @ google-maps ---
[INFO] Searching for local aggregator root...
[INFO] Local aggregation root: /home/ghrunner/actions-runner/_work/vaadin-ecosystem-build/vaadin-ecosystem-build/work/Google Maps Add-on
[INFO] Processing change of com.flowingcode.vaadin.addons:vaadin-bom:2.4.1-SNAPSHOT -> 24.9-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.007 s
[INFO] Finished at: 2026-03-18T05:38:12Z
[INFO] ------------------------------------------------------------------------
[INFO] Scanning for projects...
[INFO] 
[INFO] -------------< com.flowingcode.vaadin.addons:google-maps >--------------
[INFO] Building Google Maps Addon 2.4.1-SNAPSHOT
[INFO]   from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] 
[INFO] --- clean:3.2.0:clean (default-clean) @ google-maps ---
[INFO] Deleting /home/ghrunner/actions-runner/_work/vaadin-ecosystem-build/vaadin-ecosystem-build/work/Google Maps Add-on/target
[INFO] 
[INFO] --- resources:3.3.1:resources (default-resources) @ google-maps ---
[INFO] Copying 3 resources from src/main/resources to target/classes
[INFO] 
[INFO] --- vaadin:24.2.6:prepare-frontend (default) @ google-maps ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  29.315 s
[INFO] Finished at: 2026-03-18T05:38:43Z
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal com.vaadin:vaadin-maven-plugin:24.2.6:prepare-frontend (default) on project google-maps: Could not execute prepare-frontend goal. 
[ERROR] 
[ERROR] ======================================================================================================
[ERROR] Your installed 'npm' version (9.2.0) is known to have problems.
[ERROR] Please update to a new one either:
[ERROR]   - by following the https://nodejs.org/en/download/ guide to install it globally%n  - or by updating your global npm installation with `npm install -g npm@latest`
[ERROR]   - or by running the frontend-maven-plugin goal to install it in this project:
[ERROR]   $ mvn com.github.eirslett:frontend-maven-plugin:1.10.0:install-node-and-npm -DnodeVersion="v20.9.0" 
[ERROR] 
[ERROR] You can disable the version check using -Dvaadin.ignoreVersionChecks=true
[ERROR] ======================================================================================================
[ERROR] -> [Help 1]
[ERROR] 
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] 
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoFailureException

[javier-godoy]

Vaadin 24.2.6 supports NPM 8.6+ (and installs 10.1.0 by default). It's likely that Ecosystem is using the wrong version of npm.