VSCode按F5调试Flutter触发MissingPluginException问题求助

问题背景 #

使用VSCode进行Flutter开发时，通过命令行执行以下命令可正常调试：

fvm flutter run --debug --flavor production --target lib/main-production.dart

但在VSCode中按F5启动调试时，会在platform_channel.dart的_invokeMethod方法抛出MissingPluginException异常。

当前环境与配置 #

FVM环境信息 #

• FVM版本：2.4.1
• Flutter版本：2.10.5（stable通道）
• 项目配置文件.fvm/fvm_config.json：

{
  "flutterSdkVersion": "2.10.5",
  "flavors": {}
}

• 已设置项目及全局Flutter版本为2.10.5，VSCode已关联项目内.fvm/flutter_sdk路径

VSCode launch.json配置 #

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Production(Debug)",
      "request": "launch",
      "type": "dart",
      "program": "lib/main-production.dart",
      "args": [
        "--debug",
        "--flavor",
        "production",
      ]
    },
  ]
}

异常代码片段 #

抛出异常的代码位于~/fvm/versions/2.10.5/packages/flutter/lib/src/services/platform_channel.dart：

@optionalTypeArgs
Future<T?> _invokeMethod<T>(String method, { required bool missingOk, dynamic arguments }) async {
  assert(method != null);
  final ByteData? result = await binaryMessenger.send(
    name,
    codec.encodeMethodCall(MethodCall(method, arguments)),
  );
  if (result == null) {
    if (missingOk) {
      return null;
    }
    throw MissingPluginException('No implementation found for method $method on channel $name');
  }
  return codec.decodeEnvelope(result) as T?;
}

排查建议 #

• 调整launch.json的flavor配置方式：VSCode的Dart插件对flavor参数有单独配置项，建议将flavor从args中移出，单独设置字段：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Production(Debug)",
      "request": "launch",
      "type": "dart",
      "program": "lib/main-production.dart",
      "flavor": "production",
      "args": ["--debug"]
    }
  ]
}

• 清理全量构建缓存：命令行与VSCode的构建缓存可能存在差异，执行以下命令清理后重新构建：

fvm flutter clean
fvm flutter pub get
# iOS环境额外执行
cd ios && pod deintegrate && pod install && cd ..

• 确认VSCode Dart插件的SDK路径：检查VSCode设置中Dart: Flutter SDK Path是否指向项目内的.fvm/flutter_sdk，避免插件误使用其他路径的Flutter版本。

• 检查平台通道注册逻辑：确保在调用平台方法前，对应平台通道已完成注册；针对flavor环境，需确认插件是否在对应flavor的原生配置（Android的productFlavors、iOS的Scheme）中正确初始化。

• 对比调试命令差异：查看VSCode调试控制台输出的实际执行命令，与手动执行的命令行参数做对比，调整launch.json参数完全匹配。

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