运行app必现
海上嘀嘀嘀
- 发布：2026-03-13 11:41
- 更新：2026-03-13 11:41
- 阅读：9
产品分类： uniapp/App
PC开发环境操作系统： Windows
PC开发环境操作系统版本号： Windows11， 64 位操作系统
HBuilderX类型： 正式
HBuilderX版本号： 4.87
手机系统： iOS
手机系统版本号： iOS 17
手机厂商： 苹果
手机机型： iPhone14
页面类型： vue
vue版本： vue3
打包方式： 离线
项目创建方式： HBuilderX
操作步骤：
预期结果：
正常展示app
正常展示app
实际结果：
app 显示白屏
app 显示白屏
bug描述：
问题1：iOS原生工程有control.xml文件，报错：读取自定义基座control.xml文件失败
问题2：原生工程sdk是4.87，hbuilder版本也是4。87，报错：当前自定义基座的sDK与HBuilderx自带的基座sDK版本不一致，
运行到手机上，启动app，展示空白页
Ask小助手 - Ask社区AI助手
欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。
作为 DCloud 官方人员，我对该 bug 反馈进行如下评审：
反馈质量评价
该反馈内容基本完整但关键细节缺失，属于中级质量的 bug 反馈。具体评价如下：
1. 内容完整性分析
不足之处：
- 复现步骤过于简单：仅描述"运行app必现"，缺少关键操作细节（如何运行？使用标准基座还是自定义基座？是否通过 HBuilderX 的"运行到手机"功能？）
- 缺少项目配置信息：未说明是标准 uni-app 还是 uni-app x 项目，未提供 manifest.json 的关键配置截图（特别是 App 模块配置和原生插件配置）
- 缺少错误截图/完整日志：仅文字描述两个错误，缺少控制台完整输出截图和 iOS 设备的日志信息
- 缺少代码示例：未提供 App.vue 或首页代码，无法判断白屏是否由业务代码引起
已具备的有效信息：
- 环境版本信息完整（HBuilderX 4.87、iOS 17、iPhone 14、Vue3）
- 明确指出了两个具体错误提示
- 明确了白屏现象
2. Bug 成立性判断
根据知识库 iOS 开发环境文档，该问题现象与版本不匹配导致的异常完全吻合：
"确保版本一致，请确保从 HBuilderX 导出的打包资源的 HBuilderX 的版本号和 App 离线 SDK 发布的版本号是一致的...注意：如果版本不一致，app 启动时会弹出版本不一致的提示框，并且可能导致功能异常"
您遇到的"SDK 版本不一致"报错和白屏现象，属于已知的版本匹配问题导致的异常现象，Bug 成立。
关于 control.xml 读取失败，通常与自定义基座构建过程中的资源配置有关，结合版本不一致的报错，根因很可能是自定义基座构建时使用了不匹配的资源版本。
3. 解决方案建议
基于知识库内容，请按以下步骤排查：
-
完全清理重新制作基座
- 删除手机上已安装的所有基座应用
- 删除项目
unpackage/debug目录下的旧基座文件 - 在 HBuilderX 中重新制作 iOS 自定义基座
-
严格核对版本一致性
- 确认使用的 iOS 离线 SDK 版本号与 HBuilderX 版本号完全一致（您已确认都是 4.87，但请检查 SDK 的发布日期是否与 HBuilderX 4.87 的发布日期匹配）
- 确保基座是通过当前使用的 HBuilderX 4.87 版本制作的，而不是旧版本残留的基座
-
白屏处理
- 如插件市场文档所述，iOS 基座安装后白屏可尝试杀死基座进程后重新启动 App
- 确保通过 HBuilderX 菜单"运行"->"运行到手机或模拟器"->"使用自定义基座"的方式运行，而非直接安装 IPA 文件
-
检查 manifest 配置
- 确认 manifest.json 中未勾选未正确配置的模块（如 Maps、支付等模块若勾选但未配置可能导致白屏）
4. 需要补充的信息
为精准定位问题，请补充提供：
- 控制台输出的完整日志（从运行开始到白屏的完整控制台输出）
- 是标准基座还是自定义基座？如是自定义基座，请说明是云打包还是离线打包制作
- manifest.json 的 App 模块配置截图（特别是是否勾选了 Maps、扫码、支付等原生模块）
- 项目类型是 uni-app 还是 uni-app x？
结论：该问题大概率由基座版本与 HBuilderX 版本实际不匹配导致，建议严格按上述步骤 1-2 清理重建基座。如问题依旧，请补充上述信息以便进一步排查。
内容为 AI 生成，仅供参考
