nanoFramework ESP32 WiFi扫描抛出InvalidOperationException异常咨询

该异常从WiFi原生驱动层抛出，和上层C#业务代码逻辑无直接关联，常见触发原因与修复方案如下：

• 固件缺失WiFi原生驱动组件
  刷写固件时如果仅写入核心CLR镜像、未搭载对应ESP32型号的WiFi驱动包，会导致上层类库调用底层射频接口时直接返回无效操作。注意仅在C#项目中添加System.Device.Wifi的NuGet引用不代表固件自带驱动支持，刷写时要确认镜像包含WiFi相关原生组件；ESP32-C3、ESP32-S3等较新型号需使用对应型号的专属固件，不要混用通用ESP32镜像。
• 未等待WiFi适配器完成初始化就调用扫描接口
  WifiAdapter.FindAllAdapters()[0]仅能获取适配器的实例引用，不代表硬件已经完成上电和初始化流程。紧接着同步调用ScanAsync会因为底层状态未就绪触发异常。需要先监听适配器可用事件，确认硬件状态正常后再执行扫描，参考实现：

  WifiAdapter wifiAdapter = WifiAdapter.FindAllAdapters()[0];
  ManualResetEventSlim adapterReady = new ManualResetEventSlim(false);
  
  wifiAdapter.Available += (_, _) => adapterReady.Set();
  
  // 最多等待5秒让适配器完成初始化
  if (!adapterReady.WaitOne(TimeSpan.FromSeconds(5)))
  {
      throw new Exception("WiFi适配器初始化超时");
  }
  
  // 状态就绪后再执行扫描操作
  var networks = wifiAdapter.ScanAsync();
  

• nanoFramework类库版本与固件版本不匹配
  当项目中引用的nanoFramework.System.Device.Wifi等相关NuGet包版本，和设备上刷入的nanoFramework固件版本存在版本差时，托管代码与原生层的互操作参数传递会出现错位，触发无效操作异常。需要将所有nanoFramework相关的NuGet包调整到和固件完全对应的版本，禁止跨大版本混用类库。
• 硬件天线配置与实际不匹配
  部分ESP32开发板默认配置为外置天线模式，如果板载未连接外置天线、也没有在固件配置中切换为内置PCB天线，会导致射频模块初始化失败，所有WiFi相关操作都会抛出异常。可通过nanoFramework设备配置工具检查WiFi天线相关的引脚配置，匹配自身硬件的实际连接情况。

你之前尝试的重启设备、手动设置enabled参数、重复刷写同版本错误固件这几个操作，都无法覆盖上述根因，按所列顺序逐一排查即可定位问题。

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