BluetoothClient仅支持已配对的传统蓝牙设备发现，无法扫描未配对或BLE设备；搜不到设备需检查系统可见性、驱动状态及组策略限制。
Windows 上用 BluetoothClient 搜不到设备？先确认平台限制
在 .net framework 或 .net 5+ 的 windows 平台下，bluetoothclient 默认只支持 rfcomm 协议的配对设备发现，且严重依赖系统蓝牙协议栈（bth）是否启用“可被发现”模式。它根本不会扫描未配对、不可见或使用 ble（bluetooth low energy）广播的设备。
- 常见错误现象：
BluetoothClient.DiscoverDevices()返回空数组，或抛出SocketException错误码 10013（权限拒绝） - 真实使用场景：仅适用于已手动配对、且对方设备处于“可见”状态的传统蓝牙（BR/EDR）设备，比如老式蓝牙打印机、串口模块
- 关键参数差异：
DiscoverDevices(int)的参数是最大返回数量，不是超时毫秒数；超时由底层驱动控制，无法通过 API 调整 - 兼容性影响：.NET Core / .NET 5+ 在 Windows 上仍可用该类，但 Linux/macOS 完全不支持 ——
PlatformNotSupportedException会直接抛出
想扫 BLE 设备？必须换 Windows.Devices.Bluetooth.Advertisement
Windows 10 1809+ 系统原生支持 BLE 广播监听，但需要 UWP 运行时能力（即使你写的是 WinForms/WPF，也得走 WindowsRuntimeComponent 或启用 C++/CX 互操作），而且必须声明 bluetooth 功能权限。
- 常见错误现象：调用
BluetoothLEAdvertisementWatcher.Start()后无回调，或触发Stopped事件并带BluetoothLEAdvertisementWatcherStatus.DisabledByUser - 必须做的三件事：
– 在Package.appxmanifest（或项目属性 > 功能）中勾选bluetooth
– 运行时检查BluetoothAdapter.GetDefaultAsync()是否返回非 null
– 用户需在系统设置中打开“蓝牙”和“允许设备通过蓝牙查找此设备”（后者影响接收广播） - 性能注意点：
ScanningMode设为Active才能收到扫描响应（Scan Response），但耗电更高；Passive模式只收广播包（Advertising Data），适合低功耗监听
WinForms/WPF 项目里怎么安全接入 UWP 蓝牙 API？
不能直接引用 Windows.Devices.Bluetooth 命名空间到传统桌面项目，必须通过 .NET 5+ 的“Windows Runtime Support”桥接，或者用 Microsoft.Windows.SDK.Contracts NuGet 包（仅限 Windows 10 1809+）。
- 实操路径：
– 项目 SDK 改为Microsoft.NET.Sdk.WindowsDesktop
– 添加<targetframework>net6.0-windows10.0.17763.0</targetframework>（版本号不能低于 17763）
– 安装Microsoft.Windows.CsWin32（推荐）或Microsoft.Windows.SDK.Contracts - 容易踩的坑：
– 忘记在 UI 线程调用BluetoothLEAdvertisementWatcher.Start()，否则会报InvalidCastException（UWP API 强制 STA）
– 在OnReceived回调里直接更新 WinForms 控件，没用Invoke()导致跨线程异常
– 未处理Aborted事件，导致 watcher 意外停止后无感知 - 简短示例：
var watcher = new BluetoothLEAdvertisementWatcher();<br>watcher.Received += (s, e) => {<br> this.Invoke((MethodInvoker)delegate {<br> listBox.Items.Add(e.Advertisement.LocalName ?? "unknown");<br> });<br>};<br>watcher.Start();
为什么你的程序在某些电脑上完全搜不到任何蓝牙设备？
这不是代码问题，而是硬件 + 驱动 + 系统策略的组合结果。尤其在商用笔记本（ThinkPad、Dell Latitude）上，OEM 常默认禁用 BLE 广播接收，或把蓝牙芯片配置成“仅 HID 模式”。
- 排查顺序：
– 运行ms-settings:bluetooth，确认“蓝牙”开关已开，且“其他设备可发现此设备”已启用
– 在设备管理器中右键蓝牙适配器 → “属性” → “高级”选项卡，检查是否存在“EnableLowEnergy”或类似注册表开关（部分 Realtek/Atheros 驱动提供）
– 用 PowerShell 运行Get-PnpDevice -Class Bluetooth | Where-Object {$_.Status -eq "OK"}，确认驱动状态正常 - 最容易被忽略的一点：Windows 组策略可能锁定蓝牙行为。域控环境或教育版系统中，
Computer Configuration > Administrative Templates > Network > Bluetooth下的“Allow Bluetooth SDP Server”若被禁用，BluetoothClient类将彻底失效
