Mac端CoreBluetooth创建的BLE外设无法被iPhone发现求助

以下是针对你的问题的具体排查和修复步骤：

1. 修正广告启动时机（核心问题） #

你的代码在CBPeripheralManager初始化后立即调用startAdvertising，但此时蓝牙状态可能尚未就绪，且服务还未被添加到外设管理器中。苹果的BLE框架要求广播的服务UUID必须已被添加到外设，否则不会对外正常广播。

修改代码流程： #

将服务添加和广告启动逻辑移到蓝牙状态就绪后的回调中，并在服务添加成功后再启动广告：

// 初始化时指定回调队列，避免线程问题
let peripheralManager = CBPeripheralManager(delegate: self, queue: DispatchQueue.main)
let service = CBMutableService(type: CBUUID(string: "0003ABCD-0000-1000-8000-00805F9B0131"), primary: true)
let readCharacteristic = CBMutableCharacteristic(
    type: CBUUID(string: "00031201-0000-1000-8000-00805F9B0130"),
    properties: .read,
    value: nil,
    permissions: .readable
)
let writeCharacteristic = CBMutableCharacteristic(
    type: CBUUID(string: "00031202-0000-1000-8000-00805F9B0130"),
    properties: .write,
    value: nil,
    permissions: .writeable
)

// MARK: - CBPeripheralManagerDelegate
func peripheralManagerDidUpdateState(_ peripheral: CBPeripheralManager) {
    switch peripheral.state {
    case .poweredOn:
        service.characteristics = [readCharacteristic, writeCharacteristic]
        peripheralManager.add(service)
        print("蓝牙就绪，开始添加服务")
    case .poweredOff:
        print("蓝牙未开启，请打开蓝牙")
    case .unauthorized:
        print("蓝牙权限未授权，请在系统设置中开启")
    case .unsupported:
        print("当前设备不支持BLE")
    default:
        break
    }
}

// 服务添加成功后启动广告
func peripheralManager(_ peripheral: CBPeripheralManager, didAdd service: CBService, error: Error?) {
    guard error == nil else {
        print("添加服务失败：\(error!.localizedDescription)")
        return
    }
    let advertisementData = [
        CBAdvertisementDataLocalNameKey: "BLE Serial",
        CBAdvertisementDataServiceUUIDsKey: [service.uuid]
    ] as [String : Any]
    peripheralManager.startAdvertising(advertisementData)
    print("BLE外设开始广播")
}

2. 确保蓝牙权限配置正确 #

苹果设备对BLE权限有严格要求，缺少权限会导致外设无法广播或被发现：

iOS端配置： #

在Info.plist中添加以下键值对：

<key>NSBluetoothAlwaysUsageDescription</key>
<string>需要蓝牙权限以创建和管理BLE外设</string>

（iOS 13及以上必须使用NSBluetoothAlwaysUsageDescription，旧版的NSBluetoothPeripheralUsageDescription已废弃）

MacOS端配置： #

1. 在Info.plist中添加：

<key>NSBluetoothAlwaysUsageDescription</key>
<string>需要蓝牙权限以创建和管理BLE外设</string>

2. 打开系统偏好设置 → 安全与隐私 → 隐私 → 蓝牙，确保你的应用被允许访问蓝牙。

3. 检查后台广播配置（如果需要后台运行） #

如果你的应用需要在后台保持BLE广播，需开启对应的后台模式：

• iOS：在项目的Signing & Capabilities中添加Background Modes，勾选Bluetooth Peripheral。
• MacOS：在Signing & Capabilities中添加Background Modes，勾选Bluetooth Sharing。

4. 设备蓝牙状态排查 #

• 确保Mac和iPhone的蓝牙都已正常开启，无硬件故障。
• 尝试重置设备蓝牙：
  • iPhone：设置 → 蓝牙 → 关闭再开启；或通用 → 传输或还原iPhone → 还原 → 还原网络设置（不会删除数据）。
  • Mac：系统偏好设置 → 蓝牙 → 关闭，等待10秒后重新开启；或重启Mac。

5. 验证UUID格式 #

确保使用的是有效的128位UUID（格式为XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX），避免使用苹果保留的UUID段。

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