从 vaadin 24.1 起，官方已移除对 node.js 和 npm 的强制依赖，只要不使用 littemplate、polymer 组件或需自定义前端打包的第三方插件，即可纯 java 构建并部署生产包。
从 vaadin 24.1 起，官方已移除对 node.js 和 npm 的强制依赖，只要不使用 littemplate、polymer 组件或需自定义前端打包的第三方插件，即可纯 java 构建并部署生产包。
Vaadin 长期以来因前端资源（如 Web Components、CSS、TypeScript）的构建依赖 npm 而被企业用户诟病——尤其在受严格安全管控、禁止安装 Node.js 的生产环境中，这一限制常导致 CI/CD 流水线卡顿或部署失败。好消息是：自 Vaadin 24.1（2023 年 9 月发布）起，这一限制已被彻底解除。
✅ 前提条件（必须全部满足）：
- 使用 Vaadin 24.1 或更高版本（推荐 24.4+ 稳定版）；
- 不使用
LitTemplate或PolymerTemplate（即完全基于 Java Server-Side Rendering，如VerticalLayout,Grid,Button等标准组件）； - 不引入依赖前端构建的第三方 Add-ons（例如旧版
vaadin-charts、vaadin-rich-text-editor的早期版本等；请查阅对应插件的兼容性说明）； - 未手动启用
frontend.hotdeploy或自定义webpack.config.js/vite.config.ts。
✅ 构建方式（纯 Maven，零 npm）：
只需执行标准 Maven 打包命令，Vaadin 将自动使用内置的 Java-based frontend bundler（基于 Esbuild 的轻量级 Java 封装）完成生产资源生成：
mvn clean package -Pproduction
✅ 注：
-Pproduction激活 Vaadin 内置的 production profile，自动启用资源压缩、代码分割与哈希指纹；无需npm install或npm run build。
? 验证是否真正免 npm：
构建过程中若出现以下日志，则表明成功绕过 Node.js：
[INFO] Skipping npm install (not needed for this project) [INFO] Using built-in frontend bundler (esbuild-java) [INFO] Bundling frontend resources in production mode...
⚠️ 注意事项：
- 若项目中存在
frontend/目录下自定义的.js、.css或index.html修改，Vaadin 24.1+ 仍会尝试处理，但不支持需 npm 插件（如 Sass 编译、TypeScript 转译）的复杂前端逻辑——此类场景仍需保留 Node.js。 - 升级前务必运行
mvn vaadin:upgrade（Vaadin Maven Plugin 提供）并检查pom.xml中的<vaadin.version></vaadin.version>与插件版本一致性。 - 对于已有 Vaadin 23/24.0 项目，升级后需删除
package.json、node_modules/及target/frontend/，并清除 Maven 本地仓库中相关插件缓存，避免残留依赖干扰。
? 总结：
Vaadin 24.1 是企业级 Java Web 开发的重要分水岭——它让“纯后端团队独立交付完整 Web 应用”成为现实。只要坚持服务端组件开发范式，即可告别 Node.js 审批流程、npm 权限申请与前端环境维护成本，真正实现 Java-centric, npm-free production deployment。
