iOS集成WatchConnectivity后启动出现‘Application context data is nil’日志的原因

问题场景 #

我创建了一个简易应用复现该问题：通过「File -> New -> Project... -> App」创建默认项目，替换ContentView.swift为如下代码后，在iPhone 15 Pro（17.5）模拟器运行。即使在安装了对应Watch应用的物理设备上运行，也会出现相同的错误日志。

控制台输出：

Application context data is nil
Application context data is nil
WCSession counterpart app not installed

复现代码 #

import WatchConnectivity

struct ContentView: View {
    let wcManager = WatchConnectivityManager.shared
    var body: some View {
        VStack {
        }
    }
}

class WatchConnectivityManager: NSObject {
    static let shared: WatchConnectivityManager = WatchConnectivityManager()
        
    private override init() {
        super.init()
        WCSession.default.delegate = self
        WCSession.default.activate()
    }
}
extension WatchConnectivityManager: WCSessionDelegate{
    func sessionDidBecomeInactive(_ session: WCSession) {
    }
    func sessionDidDeactivate(_ session: WCSession) {
    }
    func session(_ session: WCSession, activationDidCompleteWith activationState: WCSessionActivationState, error: Error?) {
    }
    func session(_ session: WCSession, didReceiveMessage message: [String : Any], replyHandler: @escaping ([String : Any]) -> Void) {
    }
}

疑问 #

设置断点后发现activationDidCompleteWith方法被调用且error为nil。此时WCSession刚激活，尚未尝试发送消息，请问为何会出现‘Application context data is nil’的日志提示？

解答 #

这条“Application context data is nil”日志并非来自你的业务代码，而是WatchConnectivity框架内部的调试输出，和你是否主动发送消息没有关系。

具体原因：

1. 应用上下文同步机制：WCSession激活后，系统框架会自动尝试将当前应用的**应用上下文（applicationContext）**同步到配对的设备上。如果你的应用从未调用过updateApplicationContext(_:)设置上下文数据，或者当前WCSession.default.applicationContext是空字典，框架就会输出这条日志，提示没有可同步的上下文内容。
2. 配对应用检测：而“WCSession counterpart app not installed”日志则说明，当前设备配对的Apple Watch上没有安装对应的Watch应用，或者iOS与Watch应用的配置不匹配，导致WCSession无法识别到配对应用。即使物理设备上安装了Watch应用，也需要确保：
   • iOS和Watch应用使用同一个Team ID签名
   • 两者都在Xcode的Capabilities中开启了Watch Connectivity功能
   • 若需要共享数据，需配置相同的App Group

解决建议：

• 对于“Application context data is nil”日志：你可以直接忽略它，不会影响WCSession的正常工作；如果想要消除这条日志，可以在WCSession激活成功后主动设置一次空的应用上下文：

func session(_ session: WCSession, activationDidCompleteWith activationState: WCSessionActivationState, error: Error?) {
    guard activationState == .activated else { return }
    do {
        try session.updateApplicationContext([:])
    } catch {
        print("更新应用上下文失败: \(error.localizedDescription)")
    }
}

• 对于“WCSession counterpart app not installed”日志：检查Watch应用是否正确安装到配对的Apple Watch上，同时核对iOS与Watch应用的签名、Capabilities配置是否一致。

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