Vaadin Gradle项目启动失败：VaadinFlowPluginExtension缺失及配置缓存问题

1. 对齐Gradle版本与Vaadin 24兼容性 #

Vaadin 24要求Gradle版本处于7.5到8.x区间，版本不匹配会直接引发插件扩展识别异常：

• 修改gradle/wrapper/gradle-wrapper.properties中的distributionUrl为兼容版本，示例：

  distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip
  

• 执行命令更新Gradle wrapper：

  ./gradlew wrapper --gradle-version 8.5
  

2. 修正Vaadin插件配置 #

VaadinFlowPluginExtension不存在通常是插件引入格式错误或版本不一致导致：

• 打开项目的build.gradle.kts（或Groovy版build.gradle），确保插件引入格式正确并使用Vaadin 24的稳定版本，示例KTS配置：

  plugins {
      id("com.vaadin") version "24.3.8"
      id("org.springframework.boot") version "3.2.0"
      id("io.spring.dependency-management") version "1.1.4"
      kotlin("jvm") version "1.9.20"
      kotlin("plugin.spring") version "1.9.20"
  }
  

• 保证插件版本与项目中Vaadin依赖版本完全一致，避免跨版本混用

3. 解决配置缓存冲突 #

:vaadinPrepareFrontend调用Task.project不兼容配置缓存，可通过以下方式处理：

• 临时禁用配置缓存（若无需该功能），在gradle.properties中添加：

  org.gradle.configuration-cache=false
  

• 升级Vaadin插件到24.3.8及以上版本，官方已在后续补丁中修复该配置缓存兼容性问题
• 若必须启用配置缓存，检查项目自定义任务，避免直接调用Task.project，调整实现逻辑符合Gradle配置缓存规范

4. 清理缓存后重新构建 #

执行以下命令清理残留构建文件与缓存：

./gradlew clean
rm -rf .gradle/ build/ node_modules/ package-lock.json package.json

随后重新执行构建任务：

./gradlew bootRun

内容的提问来源于stack exchange，提问作者Jason The Dynamite