PAYATHON 2026

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。

排查时先分清两件事:

  1. EXC_BREAKPOINT 并非普通的 Objective-C 或 Swift 崩溃,先按 UIKit 启动诊断排查,别只盯 JS。
  2. 只加 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 的运行时检查可能不一样;以上只针对这个报错给出最小兼容修复思路。

备注:内容仅供参考。