iphone14 手机,ios16.0.3 版本,在 uniapp@4.87 版本中运行到手机基座,项目编译正常,显示有问题
- 发布:2026-04-08 11:07
- 更新:2026-04-08 11:09
- 阅读:14
产品分类: uniapp/App
PC开发环境操作系统: Mac
PC开发环境操作系统版本号: macos 26.3.1
HBuilderX版本号: 4.87
手机系统: iOS
手机系统版本号: iOS 16
手机厂商: 苹果
手机机型: iphone14
页面类型: vue
vue版本: vue3
打包方式: 云端
项目创建方式: CLI
CLI版本号: unibest-version: "3.18.9"
操作步骤:
预期结果:
正常编译打包,iphone14 真机显示正常
正常编译打包,iphone14 真机显示正常
实际结果:
app 项目显示白屏,没有显示自定义 tabbar
app 项目显示白屏,没有显示自定义 tabbar
bug描述:
涉及机型:iphone14,ios16.0.3; iphone12, ios 15
uniapp 项目运行结果:
10:54:55.933 项目 uniapp-wmall 编译成功。
10:54:55.960 正在同步手机端程序文件...
10:54:56.769 开始差量编译...
10:54:56.777 Generating image constants...
10:54:56.778 No changes in assets. Skip writing: /Users/amor/wlyd/uniapp-wmall/src/static/r.ts
10:54:56.778 Watching for changes in /Users/amor/wlyd/uniapp-wmall/src/static/images-2.0
10:54:56.814 Initial scan complete, ready for changes
10:55:01.457 同步手机端程序文件完成
手机运行效果如附件,显示白屏
备注:同样的项目在 iphone8的 ios16.7.15上运行正常。目前只发现iphone14,ios16.0.3; iphone12, ios 15有问题
云打包之后上架的版本,这两个机器打开也白屏
Ask小助手 - Ask社区AI助手
作为 DCloud 官方人员,我对该 bug 反馈进行如下评审:
反馈内容完整性评估
基本信息完整性:良好
- 环境信息提供较全:HBuilderX 4.87 正式版、Mac 开发环境、Vue3 项目、iOS 16 系统
- 对比测试信息有价值:iPhone 8 (iOS 16.7.15) 运行正常,而 iPhone 14 (iOS 16.0.3) 和 iPhone 12 (iOS 15) 白屏,说明是特定机型或系统版本兼容性问题
关键缺陷:缺少技术诊断必要信息
- 控制台日志缺失:白屏问题必须提供运行时的 Console 日志(特别是红色报错信息),目前仅提供了编译日志,无法判断是 JavaScript 执行错误、资源加载失败还是渲染层问题
- 代码示例缺失:没有提供可复现的页面代码或项目结构说明,特别是提到的"unibest 框架"具体版本和配置未知
- manifest 配置缺失:未提供 manifest.json 中 app-plus 相关配置,特别是是否使用了自定义 tabbar、webview 配置或 plus 相关设置
- 基座类型未说明:未明确说明使用的是标准基座还是自定义基座,以及是否尝试过重新制作基座
Bug 成立性分析
从现象描述看,该 Bug 可能成立,属于特定机型兼容性问题:
- 编译成功但运行白屏,且云打包后同样问题,排除开发环境临时问题
- iPhone 8 正常但 iPhone 14 白屏,指向 iOS WebView 或机型特定 API 兼容性
- 提到"没有显示自定义 tabbar",可能是 tabbar 配置或页面渲染异常导致
知识库关联:在现有知识库中未检索到 iPhone 14 特定白屏问题的已知记录,但发现 release 4.29 曾修复 iPhone 16 设备无法获取手机型号及 iOS 18 系统 API 调用问题,说明 iOS 新版本确实存在过兼容性修复。
是否涉及基本概念问题
可能涉及的概念问题:
- 项目使用了"unibest 框架"(第三方模板),可能存在与特定 iOS 版本不兼容的代码或依赖
- 白屏通常由 JavaScript 语法错误(如 ES6+ 语法在旧 JSCore 不支持)、CSS 兼容性或资源路径错误导致
评审结论与建议
当前反馈评级:需补充信息
该反馈描述了明确的兼容性问题现象,但缺乏官方复现所需的关键技术信息。建议用户补充以下内容:
- 控制台错误日志:连接手机后 HBuilderX 控制台输出的红色报错信息(关键)
- 最小复现代码:提供一个简单的 vue 页面代码,确认是否所有页面白屏还是特定页面
- manifest.json 配置:特别是
app-plus节点下的usingComponents、nvue或renderer相关配置 - 测试验证:尝试在 iPhone 14 上运行一个纯净的 Hello uni-app 模板项目,确认是框架问题还是项目特定问题
临时排查建议(基于知识库中 iOS 兼容性处理经验):
- 检查是否使用了
app-plus下的kernel配置,尝试切换 WebView 内核 - 检查项目是否包含 ES6+ 语法未转译,或使用了 iOS 16.0.3 不支持的 CSS 属性
- 如使用自定义 tabbar,检查 tabbar 页面路径配置是否正确
请补充上述信息后,官方可进一步定位是 uni-app 引擎问题、特定机型 WebView 兼容性问题,还是 unibest 框架的适配问题。