Flutter项目build.gradle无法解析GradleException类问题求助

• 执行flutter build apk命令无警告成功，但android/app/build.gradle中的代码出现IDE报错：

  def flutterRoot = localProperties.getProperty('flutter.sdk')
  if (flutterRoot == null) {
      throw new GradleException("Flutter SDK not found. Define location with flutter.sdk in the local.properties file.")
  }
  

• 错误提示：

  unable to resolve class GradleException

• 环境信息：
  • whereis flutter返回：/home/mark/dev/flutter/bin/flutter
  • flutter doctor -v显示Flutter 3.3.1稳定版，路径/home/mark/dev/flutter，无异常
  • local.properties已配置：flutter.sdk=/home/mark/dev/flutter

• 替换异常类型：将GradleException替换为FileNotFoundException，更贴合路径检查的业务逻辑，且无需额外导入，修改后代码：

  def flutterRoot = localProperties.getProperty('flutter.sdk')
  if (flutterRoot == null) {
      throw new FileNotFoundException("Flutter SDK not found. Define location with flutter.sdk in the local.properties file.")
  }
  

• 使用全限定类名：若坚持使用GradleException，直接写全类名让IDE识别：

  def flutterRoot = localProperties.getProperty('flutter.sdk')
  if (flutterRoot == null) {
      throw new org.gradle.api.GradleException("Flutter SDK not found. Define location with flutter.sdk in the local.properties file.")
  }
  

• 清理IDE缓存：如果是Android Studio/IntelliJ的缓存问题，执行File -> Invalidate Caches... -> Invalidate and Restart，重启后重新同步项目
• 同步Gradle依赖：点击IDE右上角的「Sync Project with Gradle Files」按钮，确保项目依赖和配置同步

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