Flutter安卓构建报错：配置:iris_method_channel项目时触发空指针异常

DevOps 小满

2026-7-8

解决Flutter安卓构建时iris_method_channel的NullPointerException问题

你遇到的是安卓构建阶段iris_method_channel模块配置时的空指针错误，原因是该模块的Gradle脚本尝试调用String.startsWith()但versionOutput变量为null，通常和版本检测逻辑失败、本地SDK/Gradle环境不兼容有关。以下是具体解决步骤：

检查并同步Android SDK组件
打开Android Studio的SDK Manager，确认Android SDK Build-Tools、**NDK (Side by side)**为最新稳定版，且与项目android/build.gradle中compileSdkVersion、targetSdkVersion配置的版本匹配，完成后同步项目。
清理缓存并重新获取依赖
依次执行以下命令：
```
flutter clean
rm -rf android/.gradle
flutter pub get
```
定位依赖来源并更新
用命令找出引入iris_method_channel的第三方包：
```
flutter pub deps --tree | grep iris_method_channel
```
找到对应包后，尝试升级到其最新稳定版本，若该包存在已知问题，可考虑替换为功能类似的其他包。

临时覆盖模块Gradle配置（上述方法无效时）
在项目的android/build.gradle中添加如下配置，跳过该模块有问题的版本检测任务：

subprojects {
    if (name == 'iris_method_channel') {
        afterEvaluate {
            tasks.withType(Exec).configureEach {
                if (it.name.contains('version')) {
                    it.enabled = false
                }
            }
        }
    }
}

同步Gradle后重新执行构建。