Flutter退出应用两次触发NPE崩溃：MethodChannel空对象调用问题

报错原因分析 #

这个NullPointerException的核心是：某个MethodChannel实例已被销毁/未初始化，代码仍尝试调用它的setMethodCallHandler方法。虽然你已经移除了目标插件，但大概率是原生端（Android）或Flutter端残留了该插件的相关代码逻辑，在应用销毁时触发了无效调用。

排查修复步骤 #

• 清理Android原生端残留代码
  打开android/app/src/main/kotlin/或java/目录下的FlutterActivity/FlutterFragment子类（通常是MainActivity），检查以下内容：

  • 是否遗留了对应插件的MethodChannel初始化代码、setMethodCallHandler绑定逻辑
  • 生命周期方法（如onDestroy、cleanUpFlutterEngine）中是否存在调用该MethodChannel的setMethodCallHandler(null)这类代码（如果Channel实例已被销毁，就会触发空指针）
  • 确保所有与已移除插件相关的原生代码完全删除，包括导入的包、变量声明、回调实现

• 清除Flutter端残留引用

  • 检查pubspec.yaml，确认已移除目标插件的依赖，执行flutter pub get更新依赖
  • 全局搜索dart代码，排查是否还有调用该插件方法、自定义MethodChannel实例的代码，若有则删除，并确保相关变量在组件dispose时正确置空（如果是自行创建的Channel）

• 排查生命周期时序问题
  崩溃发生在Activity销毁阶段，需确认：

  • 原生端是否在configureFlutterEngine之外的时机操作了插件相关的Channel
  • 如果使用了FlutterEngine缓存（如CachedEngineFragment），需确保插件对应的Channel在Engine销毁时正确解除绑定，避免无效回调

• 清理构建缓存

  • 执行flutter clean清除Flutter侧构建缓存
  • 进入Android目录执行./gradlew clean清除原生侧构建缓存，之后重新编译运行应用

• 定位具体报错位置
  如果能获取完整崩溃堆栈（当前仅提供核心报错行），可以直接找到调用setMethodCallHandler的具体类和方法，快速定位残留代码；若没有完整堆栈，可在Android Studio中运行应用，触发崩溃后查看Logcat的详细堆栈信息，找到报错的具体代码行。

修复示例（原生端） #

假设之前插件在MainActivity.kt中遗留了如下代码：

private lateinit var oldPluginChannel: MethodChannel

override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
    super.configureFlutterEngine(flutterEngine)
    oldPluginChannel = MethodChannel(flutterEngine.dartExecutor.binaryMessenger, "old_plugin_channel_id")
    oldPluginChannel.setMethodCallHandler(this)
}

override fun onDestroy() {
    super.onDestroy()
    oldPluginChannel.setMethodCallHandler(null) // 移除插件后未删除此行，导致空指针
}

需将上述所有与oldPluginChannel相关的代码完全删除，包括变量声明、初始化、回调绑定及销毁时的调用。

内容的提问来源于stack exchange，提问作者EL TEGANI MOHAMED