调用Method Channel触发空指针异常，如何定位涉事SDK/库？

异常栈信息 #

Caused by java.lang.NullPointerException: Attempt to invoke virtual method 'void io.flutter.plugin.common.MethodChannel.setMethodCallHandler(io.flutter.plugin.common.MethodChannel$MethodCallHandler)' on a null object reference
       at io.flutter.plugins.firebase.firestore.FlutterFirebaseFirestorePlugin.onDetachedFromEngine(FlutterFirebaseFirestorePlugin.java:1)
       at io.flutter.embedding.engine.FlutterEngineConnectionRegistry.remove(FlutterEngineConnectionRegistry.java:23)
       at io.flutter.embedding.engine.FlutterEngineConnectionRegistry.remove(FlutterEngineConnectionRegistry.java:28)
       at io.flutter.embedding.engine.FlutterEngineConnectionRegistry.removeAll(FlutterEngineConnectionRegistry.java:1)
       at io.flutter.embedding.engine.FlutterEngineConnectionRegistry.destroy(FlutterEngineConnectionRegistry.java:3)
       at io.flutter.embedding.engine.FlutterEngine.destroy(FlutterEngine.java:4)
       at io.flutter.embedding.android.FlutterActivityAndFragmentDelegate.onDetach(FlutterActivityAndFragmentDelegate.java:15)
       at io.flutter.embedding.android.FlutterFragment.onDetach(FlutterFragment.java:4)
       at androidx.fragment.app.Fragment.performDetach(Fragment.java:3)
       at androidx.fragment.app.g0.i(FragmentStateManager.java:3)
       at androidx.fragment.app.g0.m(FragmentStateManager.java:46)
       at androidx.fragment.app.SpecialEffectsController$b.e(SpecialEffectsController.kt:2)
       at androidx.fragment.app.SpecialEffectsController$Operation.d(SpecialEffectsController.kt:4)
       at androidx.fragment.app.SpecialEffectsController.n(SpecialEffectsController.kt:21)
       at androidx.fragment.app.FragmentManager.U(FragmentManager.java:6)
       at androidx.fragment.app.FragmentManager.F(FragmentManager.java:5)
       at androidx.fragment.app.r.f(FragmentController.java:1)
       at androidx.fragment.app.o.onDestroy(FragmentActivity.java:2)
       at android.app.Activity.performDestroy(Activity.java:7241)
       at android.app.Instrumentation.callActivityOnDestroy(Instrumentation.java:1271)
       at android.app.ActivityThread.performDestroyActivity(ActivityThread.java:4484)
       at android.app.ActivityThread.handleDestroyActivity(ActivityThread.java:4515)
       at android.app.ActivityThread.-wrap5()
       at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1690)
       at android.os.Handler.dispatchMessage(Handler.java:106)
       at android.os.Looper.loop(Looper.java:164)
       at android.app.ActivityThread.main(ActivityThread.java:6626)
       at java.lang.reflect.Method.invoke(Method.java)
       at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:438)
       at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:811)

问题描述 #

调用Method Channel方法时触发上述空指针异常，该问题仅在生产环境出现，开发环境无法复现，目前无法定位涉事的SDK/库。

排查步骤 #

• 锁定核心关联库：从栈顶日志直接看出异常来自FlutterFirebaseFirestorePlugin，优先排查Firebase Cloud Firestore相关插件（cloud_firestore）的版本兼容性，查看官方是否有对应版本的已知bug记录。
• 检查生产环境混淆规则：ProGuard/R8混淆可能误删MethodChannel实例的引用，确保Flutter插件类被正确保留，在proguard-rules.pro中添加：

  -keep class io.flutter.plugin.common.** { *; }
  -keep class io.flutter.plugins.firebase.firestore.** { *; }
  

• 添加调用栈追踪日志：在Android端自定义MethodChannel包装类，重写setMethodCallHandler方法记录调用栈，生产环境收集这些日志定位调用方：

  public class TrackedMethodChannel extends MethodChannel {
      public TrackedMethodChannel(BinaryMessenger messenger, String name) {
          super(messenger, name);
      }
  
      @Override
      public void setMethodCallHandler(@Nullable MethodCallHandler handler) {
          Log.d("MethodChannelTrack", "setMethodCallHandler called for channel: " + getName(), new Throwable());
          super.setMethodCallHandler(handler);
      }
  }
  

  替换插件默认的MethodChannel为自定义实现，或通过字节码插桩全局记录。
• 模拟生产场景复现：在开发环境尝试快速销毁Activity、模拟后台进程回收、切换多FlutterEngine等操作，复现异常触发条件。
• 检查插件生命周期逻辑：查看FlutterFirebaseFirestorePlugin的onDetachedFromEngine实现，确认MethodChannel实例是否在销毁前被提前置空，是否存在重复销毁的逻辑。
• 排查插件冲突：检查项目中其他第三方插件是否与Firebase插件存在生命周期冲突，比如同时操作FlutterEngine的ConnectionRegistry导致资源释放顺序异常。

内容的提问来源于stack exchange，提问作者ivan fuenmayor