MultipeerConnectivity连接不稳定及数据传输失败问题排查求助

核心排查点与修复方案 #

1. 强引用关键MultipeerConnectivity实例 #

MCSession、MCNearbyServiceAdvertiser、MCBrowserViewController这些核心对象必须用类属性强持有，不能是局部变量。如果在按钮点击方法里创建后未持久化，方法执行完毕对象就会被释放，直接导致代理失效、连接断开、回调无响应。

检查代码是否按如下方式声明属性：

class ViewController: UIViewController {
    // 用类属性强引用核心对象
    private var session: MCSession?
    private var advertiser: MCNearbyServiceAdvertiser?
    private var browser: MCBrowserViewController?
    private let myPeerID = MCPeerID(displayName: UIDevice.current.name)
    
    // ... 其他业务代码
}

2. 配置本地网络权限 #

iOS 14+要求App申请本地网络权限，否则MultipeerConnectivity无法维持稳定连接，会出现莫名断开的情况。

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

• 键：NSLocalNetworkUsageDescription
• 值：自定义权限描述（例如"需要本地网络权限以实现设备间通信"）

3. 完整实现MCSessionDelegate协议 #

必须实现所有MCSessionDelegate的必填方法，哪怕是空实现，否则代理回调会失效。重点检查连接状态和数据接收的方法：

func session(_ session: MCSession, peer peerID: MCPeerID, didChange state: MCSessionState) {
    DispatchQueue.main.async {
        switch state {
        case .connected:
            print("Connected: \(peerID.displayName)")
        case .connecting:
            print("Connecting: \(peerID.displayName)")
        case .notConnected:
            print("Disconnected: \(peerID.displayName)")
        @unknown default:
            break
        }
    }
}

func session(_ session: MCSession, didReceive data: Data, fromPeer peerID: MCPeerID) {
    if let message = String(data: data, encoding: .utf8) {
        print("Received from \(peerID.displayName): \(message)")
    }
}

// 以下为必填的空实现，不能省略
func session(_ session: MCSession, didReceive stream: InputStream, withName streamName: String, fromPeer peerID: MCPeerID) {}
func session(_ session: MCSession, didStartReceivingResourceWithName resourceName: String, fromPeer peerID: MCPeerID, with progress: Progress) {}
func session(_ session: MCSession, didFinishReceivingResourceWithName resourceName: String, fromPeer peerID: MCPeerID, at localURL: URL?, withError error: Error?) {}

4. 确保数据发送的目标PeerID正确 #

调用sendData(_:toPeers:with:)时，必须传入已连接的对等PeerID列表，不能包含自己的PeerID，也不能传空数组。示例正确写法：

@IBAction func sendDataTapped(_ sender: UIButton) {
    guard let session = session, !session.connectedPeers.isEmpty else {
        print("No connected peers available")
        return
    }
    let message = "Hello from \(myPeerID.displayName)"
    if let data = message.data(using: .utf8) {
        do {
            try session.send(data, toPeers: session.connectedPeers, with: .reliable)
            print("Data sent successfully")
        } catch {
            print("Send data error: \(error.localizedDescription)")
        }
    }
}

5. 模拟器测试补充注意事项 #

如果用模拟器测试，需确保：

• 两个模拟器都开启AirDrop（控制中心→AirDrop→设置为"所有人"）
• 模拟器系统版本与Xcode14.3兼容（优先用iOS16.4版本模拟器）
• 优先选择模拟器-模拟器或真机-真机同环境测试，避免跨环境（模拟器+真机）的网络适配问题

额外验证步骤 #

1. 连接建立后打印session.connectedPeers，确认对等设备已在列表中
2. 发送数据时捕获错误，查看是否有发送失败的具体原因
3. 检查控制台是否有权限相关错误日志（例如本地网络权限被拒绝）

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