Vaadin 24+ 应通过 vaadin-bom 统一管理依赖版本，避免手动指定导致运行时 UI 渲染失败；开发需执行 mvn vaadin:prepare-frontend 并启用 DevMode，组件事件监听须在 attach 后注册，禁用 Spring Boot DevTools 自动重启以保障热更新生效。
Vaadin 24+ 依赖怎么加进 Maven？
直接用官方推荐的 vaadin-bom 管理版本，别手动填每个模块的版本号。Vaadin 各组件（vaadin-core、vaadin-spring）版本必须严格对齐，否则编译不报错、运行时 UI 渲染失败或 WebSocket 连不上。
常见错误现象：java.lang.NoClassDefFoundError: com/vaadin/flow/component/Component，表面是缺类，实际是 vaadin-flow 和 vaadin-core 版本不匹配。
- 在
pom.xml的<dependencyManagement>块里导入 BOM：<dependency> <groupId>com.vaadin</groupId> <artifactId>vaadin-bom</artifactId> <version>24.4.0</version> <type>pom</type> <scope>import</scope> </dependency>
- 再声明具体依赖，不用写
<version>：<dependency> <groupId>com.vaadin</groupId> <artifactId>vaadin-core</artifactId> </dependency>
- 如果用 Spring Boot，优先选
vaadin-spring-boot-starter，它自动配好开发模式资源路径和 DevMode 启动逻辑
为什么启动后页面空白，控制台没报错？
Vaadin 24 默认启用生产模式构建流程，但开发阶段没跑 mvn vaadin:prepare-frontend 或没开 DevMode，前端资源（frontend/generated-flow-imports.js）就不存在，Java 后端找不到入口 JS，只返回空 HTML。
使用场景：IDE 直接点绿色三角运行 Spring Boot 主类，但没前置执行前端准备步骤。
立即学习“Java免费学习笔记（深入）”；
- 确保项目根目录有
package.json和webpack.config.js（首次添加 Vaadin 依赖后，插件会自动生成） - 开发阶段必须执行：
mvn vaadin:prepare-frontend
，否则@Route页面加载为空白 - IDE 中运行时，确认 VM options 包含
-Dvaadin.productionMode=false（Spring Boot 默认已设，但某些 IDE 模板会覆盖） - 检查浏览器 Network 面板，看是否 404 了
/VAADIN/static/client/client-*.js—— 这说明前端构建没触发
纯 Java 写 UI，怎么让按钮点击真正生效？
写了 button.addClickListener(e -> Notification.show("OK")) 却没反应，大概率是组件没被添加到当前视图的 DOM 树里，或者事件监听器注册时机不对。
参数差异：Vaadin Flow 的事件绑定是强生命周期感知的，addClickListener 必须在组件已 attach 到 UI 后调用才可靠；构造函数里直接绑通常没问题，但动态创建后手动 add() 之前绑，可能失效。
- 确保按钮已加入布局，例如：
VerticalLayout layout = new VerticalLayout(); Button button = new Button("Click"); button.addClickListener(e -> Notification.show("OK")); layout.add(button); // 必须 add 之后监听才稳定 - 避免在
onAttach(AttachEvent)外部提前保存组件引用并异步绑事件 —— Attach 前 DOM 节点未生成，事件代理无法挂载 - 如果用了
@PreserveOnRefresh，注意每次刷新会重建组件树，监听器需在每次重建后重新绑定（推荐在onAttach里绑）
DevMode 下热更新为什么经常失效？
改了 Java 类（比如 @Route 视图）后保存，浏览器没刷新或新逻辑不生效，不是 IDEA 设置问题，而是 Vaadin 的 DevMode 代理机制和 Spring Boot DevTools 存在协作盲区。
性能影响：开启 spring.devtools.restart.enabled=true 会导致 Vaadin 的热重载被绕过，因为整个 classloader 被重启，Flow 的客户端状态丢失且不触发前端增量编译。
- 开发 Vaadin 时，禁用 Spring Boot DevTools 的自动重启：
spring.devtools.restart.enabled=false
- 改 Java 类后，靠 Vaadin 插件自身的热更新（基于 JRebel 或标准 JVM agent）—— 它只替换变更类，保留 UI 状态
- 确保
vaadin-maven-plugin版本与 Vaadin BOM 一致，并启用：<configuration> <devMode>true</devMode> </configuration>
- 第一次启动后，留意控制台是否打印
DevModeHandler started on http://localhost:8080/...，没这句说明 DevMode 没激活
最易被忽略的是：Vaadin 的热更新只响应 src/main/java 下的 Java 文件变更，改 src/main/resources 或静态资源不会触发，得手动刷新浏览器。
