Visual Studio Code中Flutter用Gradle7.0.2搭配Java11仍报错如何解决

• Gradle 7.0.2与对应Android Gradle Plugin（AGP）7.0.2强制要求运行环境为Java 11及以上版本，和Android Studio自带适配JDK、自动绑定项目Gradle版本的逻辑不同，VS Code默认优先读取Flutter SDK内置JRE、旧版本Java配置路径，不会自动同步你系统全局升级的Java 11环境
• 项目gradle-wrapper配置可能未同步升级，AGP 7.0.2要求配套的Gradle发行版版本必须≥7.0.2，两者版本不匹配会直接触发构建报错
• Flutter全局环境配置未绑定Java 11路径，构建时仍调用旧版本Java运行Gradle

按以下步骤逐一验证配置即可解决：

1. 校验Gradle Wrapper版本配置
   打开项目android/gradle/wrapper/gradle-wrapper.properties文件，确认distributionUrl参数配置为适配AGP 7.0.2的版本，示例如下：

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

如果版本低于7.0.2，修改为上述配置后保存。

2. 配置VS Code Java运行时

• 打开VS Code设置页，搜索java.configuration.runtimes，点击「在settings.json中编辑」
• 添加Java 11运行时配置，将路径替换为你本地Java 11的实际安装路径：

"java.configuration.runtimes": [
  {
    "name": "JavaSE-11",
    // 以下路径三选一，匹配你本地的操作系统
    "path": "C:\\Program Files\\Java\\jdk-11.0.xx", // Windows示例
    // "path": "/Library/Java/JavaVirtualMachines/jdk-11.0.xx.jdk/Contents/Home", // macOS示例
    // "path": "/usr/lib/jvm/java-11-openjdk-amd64", // Linux示例
    "default": true
  }
]

保存配置后重启VS Code生效。

3. 同步系统全局Java环境变量

• 新增系统环境变量JAVA_HOME，值为你的Java 11安装根路径
• 在系统Path变量中添加%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（macOS/Linux）
• 移除Path变量中指向Java 8及以下版本的旧配置，避免优先级高于Java 11路径
  配置完成后新开终端执行java -version，确认输出为Java 11版本。

4. 清理缓存重新构建
   依次在项目根目录执行以下命令：

# 清理Flutter项目缓存
flutter clean
# 拉取依赖
flutter pub get
# 清理Android项目构建缓存
cd android
./gradlew clean # Windows系统执行 gradlew.bat clean
# 回到根目录重新运行
cd ..
flutter run

可选补充验证：如果仍有报错，检查项目android/build.gradle文件中的ext.kotlin_version版本，AGP 7.0.2要求Kotlin插件版本≥1.5.31，可将该参数修改为1.5.31后重试。

内容的提问来源于stack exchange，提问作者vigdora