Playground异步代码执行后触发NSCFRunLoopSemaphore断言崩溃问题排查

问题根源 #

Playground的运行机制和常规iOS/macOS项目有本质区别：PlaygroundPage.current.finishExecution()底层依赖AppKit的RunLoop信号量机制，要求必须在主线程调用。而你用默认Task执行异步代码时，Task会自动调度到后台线程执行，当在后台线程触发finishExecution，就会触发NSInternalInconsistencyException——哪怕你的代码里没有任何UI逻辑，Playground的底层实现依然对调用线程有严格约束。

另外你提到的几个现象也完全符合Playground的特性：

• 无Task时异步代码执行失败：Playground默认不会等待异步任务完成，会直接结束运行
• 无finishExecution时Playground无法停止：需要通过这个方法明确告知Playground结束运行

常规项目里没有这个问题，是因为项目中根本不会用到finishExecution这个Playground专属API，且项目的主线程RunLoop是持续运行的，不存在线程约束冲突。

修复方案 #

方案1：强制在主线程调用finishExecution #

不管异步任务在哪个线程执行，最后都切回主线程触发结束方法：

import PlaygroundSupport
import Foundation

// 开启无限执行，否则Playground会提前结束
PlaygroundPage.current.needsIndefiniteExecution = true

Task {
    // 这里写你的异步逻辑
    await fetchData()
    print("异步任务执行完成")
    
    // 切回主线程调用finish
    DispatchQueue.main.async {
        PlaygroundPage.current.finishExecution()
    }
}

// 示例异步函数
func fetchData() async {
    try? await Task.sleep(nanoseconds: 2_000_000_000)
}

方案2：让Task在主线程执行 #

通过指定Task的优先级为.main，让整个Task的执行上下文绑定主线程，这样后续调用finishExecution时自然符合线程要求：

import PlaygroundSupport
import Foundation

PlaygroundPage.current.needsIndefiniteExecution = true

// 指定Task在主线程运行
Task(priority: .main) {
    await fetchData()
    print("异步任务执行完成")
    PlaygroundPage.current.finishExecution()
}

func fetchData() async {
    try? await Task.sleep(nanoseconds: 2_000_000_000)
}

补充：崩溃栈对应说明 #

你遇到的崩溃栈通常会类似这样：

*** Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: '-[NSCFRunLoopSemaphore wait:]' called on thread that does not have an AppKit run loop.
*** First throw call stack:
(
    0   CoreFoundation                      0x00007ff80b8a137b __exceptionPreprocess + 242
    1   libobjc.A.dylib                     0x00007ff80b39d5bd objc_exception_throw + 48
    2   Foundation                          0x00007ff80c1d7a67 -[NSAssertionHandler handleFailureInMethod:object:file:lineNumber:description:] + 191
    3   AppKit                              0x00007ff80eaa6feb -[NSCFRunLoopSemaphore wait:] + 174
    4   PlaygroundSupport                   0x0000000100e0a23d -[PlaygroundPage finishExecution] + 135
    ...
)

这个栈明确指向finishExecution调用时的线程不符合AppKit RunLoop的要求，和我们分析的原因完全匹配。

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