React Native 真机 iOS 27 报 NoSceneLifecycleAdoption 崩溃
结论
从报错看,问题更可能出在 UIKit:iOS 27 真机会检查应用是否采用 UIScene 生命周期,未采用时触发断言,导致崩溃。它不像 React Native 业务代码或 JS 异常。UIApplicationEvaluateRuntimeIssueForNoSceneLifecycleAdoption 和 Thread 1: EXC_BREAKPOINT 同时出现,通常意味着 UIKit 在启动阶段主动中断了进程。模拟器正常、真机崩溃,可能是运行时或系统版本不同,模拟器没有触发这条断言;这不说明旧的生命周期写法没问题。
要在现有工程上改,可以保留 AppDelegate 和 React Native 初始化代码,不升级 RN。在 Info.plist 声明 UIApplicationSceneManifest,并让现有 AppDelegate 同时实现 UIWindowSceneDelegate,再把原来的 window.rootViewController 迁移到 UIWindowScene 对应的窗口上。
为什么会触发
从符号名看,NoSceneLifecycleAdoption 指应用没有采用 UIScene 生命周期。旧版 RN 模板通常在 AppDelegate 的 application:didFinishLaunchingWithOptions: 里直接创建 UIWindow 并设置 rootViewController。这种写法从 iOS 13 起仍能兼容运行,但在较新的 iOS 真机上,如果构建或运行环境要求采用 UIScene 生命周期,UIKit 可能触发运行时断言,直接停在 EXC_BREAKPOINT。
排查时先分清两件事:
EXC_BREAKPOINT并非普通的 Objective-C 或 Swift 崩溃,先按 UIKit 启动诊断排查,别只盯 JS。- 只加
UIApplicationSceneManifest却没有可用的UISceneDelegate,可能白屏、窗口不显示或启动异常;需要把现有 root view 接到 scene window 上。
最小修复步骤
1. 在 Info.plist 中加入 Scene Manifest
在 Info.plist 增加 UIApplicationSceneManifest。如果继续复用现有 AppDelegate 作为 scene delegate,可以这样写:
<key>UIApplicationSceneManifest</key>
<dict>
<key>UIApplicationSupportsMultipleScenes</key>
<false/>
<key>UISceneConfigurations</key>
<dict>
<key>UIWindowSceneSessionRoleApplication</key>
<array>
<dict>
<key>UISceneConfigurationName</key>
<string>Default Configuration</string>
<key>UISceneDelegateClassName</key>
<string>$(PRODUCT_MODULE_NAME).AppDelegate</string>
</dict>
</array>
</dict>
</dict>
说明:
- Swift 工程通常用
$(PRODUCT_MODULE_NAME).AppDelegate。 - Objective-C 工程通常直接写
AppDelegate。 UIApplicationSupportsMultipleScenes设为false,表示仍然按单场景应用处理,改动更小。- 如果项目已经存在
SceneDelegate,就复用现有的,不要重复声明。
2. 让现有 AppDelegate 同时实现 UIWindowSceneDelegate
以 Swift 为例,原来的 didFinishLaunchingWithOptions 不用动,只补 scene 回调。关键是把旧 window 里的 rootViewController 迁移到新的 UIWindowScene 窗口上:
import UIKit
import React
@main
class AppDelegate: UIResponder, UIApplicationDelegate, UIWindowSceneDelegate {
var window: UIWindow?
func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
) -> Bool {
// 这里保留你原来的 RN 初始化、bridge、rootView、window 创建代码
// 例如 RCTAppSetupPrepareApp、RCTBridge、RCTRootView 等
return true
}
func scene(
_ scene: UIScene,
willConnectTo session: UISceneSession,
options connectionOptions: UIScene.ConnectionOptions
) {
guard let windowScene = scene as? UIWindowScene else { return }
let rootVC = window?.rootViewController
window?.rootViewController = nil
let sceneWindow = UIWindow(windowScene: windowScene)
sceneWindow.rootViewController = rootVC
window = sceneWindow
window?.makeKeyAndVisible()
}
}
如果工程使用 Objective-C 的 AppDelegate.mm,可以在类扩展里声明 UIWindowSceneDelegate,然后加上:
@interface AppDelegate () <UIWindowSceneDelegate>
@end
- (void)scene:(UIScene *)scene
willConnectToSession:(UISceneSession *)session
options:(UISceneConnectionOptions *)connectionOptions {
if (![scene isKindOfClass:[UIWindowScene class]]) {
return;
}
UIWindowScene *windowScene = (UIWindowScene *)scene;
UIViewController *rootVC = self.window.rootViewController;
self.window.rootViewController = nil;
self.window = [[UIWindow alloc] initWithWindowScene:windowScene];
self.window.rootViewController = rootVC;
[self.window makeKeyAndVisible];
}
3. 确认 React Native 初始化只执行一次
旧模板里 bridge 和 rootView 通常在 didFinishLaunchingWithOptions 中创建。按上面的方式迁移时,不要在 scene:willConnectToSession:options: 里再新建一个 RCTBridge。scene 回调只负责把已有 root view 挂到 scene window 上;否则可能出现两个 bridge,或重复初始化、白屏、内存问题。
启动后白屏时,先检查这几处:
didFinishLaunchingWithOptions是否已经执行并创建了window.rootViewController;UISceneDelegateClassName是否写对;Info.plist修改后是否 Clean Build 并重新安装真机包;- React Native 的
moduleName、bridge 初始化是否仍在原位置。
注意事项
- 这个方案不需要升级 React Native,也不用删除原有
AppDelegate代码。 - 不要只加
UIApplicationSceneManifest却不实现 scene 回调。单场景应用同样需要一个可用的UISceneDelegate来提供窗口。 - 如果项目已有 Storyboard 或自定义
SceneDelegate,把 manifest 指向现有 scene delegate,并在其中复用 root view。 - 真机仍然崩溃时,先确认报错是否还是
UIApplicationEvaluateRuntimeIssueForNoSceneLifecycleAdoption。如果堆栈已经变化,就按新的启动阶段错误继续排查。 - 不同 Xcode、iOS SDK 和 RN 小版本对 UIScene 的运行时检查可能不一样;以上只针对这个报错给出最小兼容修复思路。
备注:内容仅供参考。
