Flutter项目迁移新系统构建报错Must provide Flutter source directory如何解决

问题根因 #

该错误本质是Android Gradle构建流程未正确读取到Flutter SDK的配置信息，flutter doctor检测正常仅代表全局环境配置无问题，项目级配置、构建缓存异常都会触发该报错。

排查解决步骤 #

• 检查项目android/local.properties配置
  确认文件内存在flutter.sdk配置项，值与实际Flutter SDK路径一致，Windows环境路径反斜杠需要转义：

  # 示例配置，和实际路径对齐即可
  sdk.dir=C:\\Users\\Barfi Nandeti\\AppData\\Local\\Android\\sdk
  flutter.sdk=C:\\src\\flutterSDK\\flutter
  

  若文件不存在直接手动新建即可。

• 清理缓存重新生成配置
  在项目根目录依次执行以下命令：

  1. 清理Flutter构建缓存：flutter clean
  2. 重新拉取项目依赖：flutter pub get
  3. 清理Gradle构建缓存：cd android && .\gradlew clean

• 校验Gradle配置完整性
  打开android/settings.gradle文件，确认包含读取flutter.sdk配置的逻辑，Flutter 2.5.0版本的标准配置如下：

  include ':app'
  def localPropertiesFile = new File(rootProject.projectDir, "local.properties")
  def properties = new Properties()
  
  assert localPropertiesFile.exists()
  localPropertiesFile.newDataInputStream().withStream { is -> properties.load(is) }
  
  def flutterRoot = properties.getProperty('flutter.sdk')
  assert flutterRoot != null : "flutter.sdk not found in local.properties"
  apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"
  

  缺失对应逻辑直接补充即可。

• 校验全局环境变量
  确认系统环境变量中FLUTTER_HOME指向C:\src\flutterSDK\flutter，且Path变量包含%FLUTTER_HOME%\bin，配置完成后重启终端/IDE生效。

若所有操作完成仍报错，直接用Android Studio打开项目android目录，在IDE设置中手动指定Flutter SDK路径后重新同步Gradle即可解决。

内容的提问来源于stack exchange，提问作者Mr. Third Eye Creations