欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。
在 iOS 26 及以上（包括 iOS 27）系统中，应用卡在启动页，通常与 iOS 系统引入的 UIScene 生命周期框架有关。目前 uni-app 的 iOS 端（特别是 UniMP SDK）尚未完成对 UIScene 生命周期的适配，在启用 UIScene 的场景下可能会导致应用无法正常初始化，从而一直卡在启动页。
针对此问题，目前的解决方案是回退到传统的 AppDelegate 生命周期模式。请检查你的 iOS 工程配置，确保没有强制启用 UIScene，将工程配置改回使用 AppDelegate。
如果上述方案未能解决问题，建议进一步排查以下常见原因：
-
离线打包基础库未全量引入：如果是离线打包，请根据官方文档核对基础库是否全部引入，基础库缺失可能导致启动卡死。详情可参考社区案例：uniapp iOS本地打包后，一直卡在启动页，无论真机还是模拟器。
-
原生混淆与 wgt 升级冲突：如果开启了 js/nvue 文件原生混淆，并通过 wgt 升级更新应用资源后再整包覆盖安装，可能导致启动卡在启动页。此问题已在 5.0 alpha 版本修复，建议升级 HBuilderX 版本。详情可参考：release-note-alpha。
-
uni-AD 广告配置问题：如果开通了 uni-AD 基础广告，首次安装可能因广告初始化问题卡在启动页（此问题在早期 3.5.0 版本引出，后续已修复）。详情可参考：ask.dcloud.net.cn/question/149192。
-
App.vue 代码异常：启动画面的关闭受应用 js 代码控制，如果 App.vue 中的代码存在异常导致无法执行，也可能停留在启动页。建议通过真机调试或 Xcode 运行查看控制台日志，定位是否存在代码报错。
1 个回复
Ask小助手 - Ask社区AI助手
在 iOS 26 及以上（包括 iOS 27）系统中，应用卡在启动页，通常与 iOS 系统引入的 UIScene 生命周期框架有关。目前 uni-app 的 iOS 端（特别是 UniMP SDK）尚未完成对 UIScene 生命周期的适配，在启用 UIScene 的场景下可能会导致应用无法正常初始化，从而一直卡在启动页。
针对此问题，目前的解决方案是回退到传统的 AppDelegate 生命周期模式。请检查你的 iOS 工程配置，确保没有强制启用 UIScene，将工程配置改回使用 AppDelegate。
如果上述方案未能解决问题，建议进一步排查以下常见原因：
离线打包基础库未全量引入：如果是离线打包，请根据官方文档核对基础库是否全部引入，基础库缺失可能导致启动卡死。详情可参考社区案例：uniapp iOS本地打包后，一直卡在启动页，无论真机还是模拟器。
原生混淆与 wgt 升级冲突：如果开启了 js/nvue 文件原生混淆，并通过 wgt 升级更新应用资源后再整包覆盖安装，可能导致启动卡在启动页。此问题已在 5.0 alpha 版本修复，建议升级 HBuilderX 版本。详情可参考：release-note-alpha。
uni-AD 广告配置问题：如果开通了 uni-AD 基础广告，首次安装可能因广告初始化问题卡在启动页（此问题在早期 3.5.0 版本引出，后续已修复）。详情可参考：ask.dcloud.net.cn/question/149192。
App.vue 代码异常：启动画面的关闭受应用 js 代码控制，如果 App.vue 中的代码存在异常导致无法执行，也可能停留在启动页。建议通过真机调试或 Xcode 运行查看控制台日志，定位是否存在代码报错。
要回复问题请先登录或注册
公告
更多>相关问题