Flutter项目出现Unresolved Reference: io/FlutterActivity问题求助

环境配置：

• Kotlin 版本：1.9.20
• JDK 版本：21
• Gradle 版本：8.3（曾尝试升级至8.6）
• AGP 版本：8.2.1

项目在其他开发者设备上可正常运行，但我执行flutter run时出现编译错误，具体信息如下：

代码片段（MainActivity.kt） #

package com.example.farmer_app

import io.flutter.embedding.android.FlutterActivity

class MainActivity: FlutterActivity() {
}

错误输出 #

Launching lib/main.dart on sdk gphone64 x86 64 in debug mode...
e: file:///Users/apple/Documents/DevProjects/farmer_app/android/app/src/main/kotlin/com/example/farmer_app/MainActivity.kt:3:8 Unresolved reference: io
e: file:///Users/apple/Documents/DevProjects/farmer_app/android/app/src/main/kotlin/com/example/farmer_app/MainActivity.kt:5:21 Unresolved reference: FlutterActivity

FAILURE: Build failed with an exception.

- What went wrong:
Execution failed for task ':app:compileDebugKotlin'.

> A failure occurred while executing org.jetbrains.kotlin.compilerRunner.GradleCompilerRunnerWithWorkers$GradleKotlinCompilerWorkAction
  Compilation error. See log for more details

- Try:

> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.
> Get more help at https://help.gradle.org

BUILD FAILED in 9s
Running Gradle task 'assembleDebug'...                              9.7s
Error: Gradle task assembleDebug failed with exit code 1

已尝试的操作 #

1. 将Gradle版本升级至8.6
2. 执行flutter doctor --verbose，所有检查项均显示正常
3. 执行./gradlew clean build，构建成功，但flutter run仍抛出相同错误

解决方案尝试方向 #

1. 确认Flutter依赖正确引入

检查android模块app/build.gradle的dependencies块，确保存在Flutter嵌入依赖：

implementation "io.flutter:flutter_embedding_debug:${flutterVersion}"
// 或Flutter自动生成的依赖配置

2. 强制刷新依赖缓存

执行以下命令彻底清除缓存并重新同步：

flutter clean
flutter pub get
cd android
./gradlew clean
./gradlew assembleDebug --refresh-dependencies

3. 切换JDK版本至17

JDK21与部分Flutter版本兼容性可能存在问题，尝试切换至JDK17：

• 修改JAVA_HOME指向JDK17安装路径
• 执行flutter doctor确认JDK版本变更后，重新运行项目

4. 检查Flutter与AGP/Gradle版本兼容性

执行flutter --version查看本地Flutter版本，若版本较低，升级至最新稳定版：

flutter upgrade

确保Flutter版本与AGP8.2.1、Gradle8.x的版本匹配。

5. 统一Kotlin插件版本

检查android根目录build.gradle中的Kotlin插件版本，确保与项目使用的Kotlin1.9.20一致：

plugins {
    id "com.android.application" version "8.2.1" apply false
    id "org.jetbrains.kotlin.android" version "1.9.20" apply false
}

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