Flutter运行时GeneratedPluginRegistrant.java报找不到ImagePickerPlugin错误

API 探路者

2026-8-6

解决Flutter ImagePickerPlugin找不到的编译错误

检查image_picker插件依赖配置
打开项目根目录的pubspec.yaml，确认已正确添加image_picker依赖，版本需适配当前Flutter版本：
```
dependencies:
  flutter:
    sdk: flutter
  image_picker: ^1.0.4 # 替换为适配你Flutter版本的最新稳定版
```
执行flutter pub get拉取依赖。
清理缓存重建项目
依次执行以下命令清理Flutter和Gradle缓存，消除旧缓存导致的异常：
```
flutter clean
cd android
./gradlew clean
cd ..
flutter pub get
```
重新生成插件注册文件
删除自动生成的GeneratedPluginRegistrant.java文件（路径：android/app/src/main/java/io/flutter/plugins/GeneratedPluginRegistrant.java），重新运行项目，Flutter会自动重新生成该文件。

校验Android配置

权限配置：确保AndroidManifest.xml中添加了必要权限（新版本image_picker会自动配置，旧版本需手动添加）：

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

SDK版本：在android/app/build.gradle中确认compileSdkVersion和targetSdkVersion符合插件要求（建议33及以上）：
```
android {
  compileSdkVersion 33
  defaultConfig {
    targetSdkVersion 33
  }
}
```

更新Flutter与Gradle版本
执行flutter upgrade升级到最新稳定版Flutter；同时更新Gradle版本，修改android/gradle/wrapper/gradle-wrapper.properties中的distributionUrl：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-all.zip # 适配Flutter最新版的Gradle版本
```