如何排查Flutter中仅Android Studio出现的Gradle编译问题

获取详细编译日志的有效方法 #

1. 直接执行Gradle编译任务 #

打开Android Studio右侧的Gradle工具窗口，定位到项目 → Tasks → android，双击对应构建变体的编译任务（如compileDebugKotlin或compileReleaseKotlin）。执行后，底部Run面板会输出完整编译日志，包含具体的Unresolved reference指向信息。

2. 调整IDE日志级别 #

进入File > Settings > Build, Execution, Deployment > Build Tools > Gradle，在Build output区域将Log level改为Debug或Info，重新构建后Build面板会展示更详细的编译过程细节。

3. 查看本地Gradle守护进程日志 #

Gradle会在项目根目录的.gradle/daemon/[你的Gradle版本号]目录下生成日志文件（格式如daemon-[进程ID].out.log），文件内记录了所有构建的完整日志，可从中查找具体错误原因。

针对Unresolved reference错误的排查步骤 #

• 验证Flutter/Dart配置
  确认File > Settings > Languages & Frameworks > Flutter中的SDK路径正确，且Dart SDK路径与Flutter捆绑的Dart（flutter/bin/cache/dart-sdk）一致。
• 重新生成插件注册文件
  删除android/app/src/main/java/io/flutter/plugins/GeneratedPluginRegistrant.java，执行flutter pub get重新生成该文件，确保插件注册信息无误。
• 检查Kotlin版本兼容性
  确认项目根目录build.gradle中的Kotlin版本与Flutter 3.24.0兼容（建议使用1.9.20及以上版本），避免版本不匹配导致编译异常。
• 关闭增量编译
  在gradle.properties中添加android.enableIncremental=false，禁用增量编译后重新构建，排除缓存旧错误的可能。
• 检查插件Android端依赖
  查看插件的android/build.gradle文件，确认所有依赖库声明正确、无版本冲突；若为本地插件，同步所有代码变更后再尝试构建。

内容的提问来源于stack exchange，提问作者Gábor