欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。
根据你提供的描述和知识库内容,iOS 上架 App Store 被拒原因是“白屏”,且页面只显示默认 tabBar、无法跳转到登录页,结合知识库中类似问题的记录,可以初步判断为启动页未正确加载或路由未跳转成功。
✅ 当前问题定位
- 现象:App 启动后白屏,只显示默认 tabBar,无法跳转登录页。
- 平台:iOS App Store 审核环境(非本地或真机调试)。
- 关键点:
uni.hideTabBar() 未执行,说明首页未加载完成或登录页未跳转。
✅ 可能原因与解决方案(基于知识库)
1. 首页未正确配置或加载失败
- 表现:App 启动后未进入预期首页,导致停留在默认 tabBar 页面。
- 解决:
- 检查
pages.json 中 pages 数组的第一个页面是否为真实的首页(如登录页)。
- 若首页是 tabBar 页面,确保
tabBar.list 中第一个 pagePath 与首页一致。
- 若首页非 tabBar 页面,不要将其配置在 tabBar 中,否则会导致白屏。
2. App Store 审核环境与本地环境差异
- 表现:本地运行正常,App Store 审核白屏。
- 可能原因:
- 审核环境为冷启动,未缓存任何数据,首屏加载失败。
- 使用了未兼容的 API 或语法,导致 JS 报错,页面未渲染。
- 解决:
- 使用自定义基座模拟冷启动环境,排查是否白屏。
- 检查控制台是否有报错(可使用 Xcode 控制台或远程日志工具)。
- 确保
onLaunch 或首页 onLoad 中没有使用未定义的变量或异步阻塞逻辑。
3. 路由跳转失败
- 表现:未跳转到登录页,停留在 tabBar 页面。
- 解决:
4. 白屏问题与版本相关
- 知识库依据:
- 更新日志 中提到:
“App-iOS平台 修复 vue3 项目 调试时启动白屏的Bug”
- 建议:
- 确保使用的是 HBuilderX 正式版 4.87 或以上。
- 若使用 alpha 版本,建议回退到稳定版本重新打包。
✅ 推荐排查步骤(按优先级)
| 步骤 |
操作 |
目的 |
| 1 |
检查 pages.json 首页配置 |
确保首页不是 tabBar 页面,或 tabBar 首页正确 |
| 2 |
使用自定义基座冷启动测试 |
模拟 App Store 审核环境 |
| 3 |
检查 onLaunch 是否有报错 |
使用 try-catch 包裹逻辑,避免阻塞 |
| 4 |
检查是否使用了不兼容语法 |
如可选链、未定义变量等 |
| 5 |
降级 HBuilderX 至 4.87 正式版 |
避免 alpha 版本白屏 bug |
✅ 补充建议
- 若仍无法定位,建议:
- 在 App Store 拒审说明中申请“附加信息”,说明使用了 uni-app 框架,并提供登录页截图。
- 使用录屏+日志方式提交申诉,说明 App 正常流程。
如需进一步协助,建议你在 DCloud 社区 发帖,附上 pages.json 和 App.vue 的 onLaunch 代码片段,官方会协助定位。
1 个回复
Ask小助手 - Ask社区AI助手
根据你提供的描述和知识库内容,iOS 上架 App Store 被拒原因是“白屏”,且页面只显示默认 tabBar、无法跳转到登录页,结合知识库中类似问题的记录,可以初步判断为启动页未正确加载或路由未跳转成功。
✅ 当前问题定位
uni.hideTabBar()未执行,说明首页未加载完成或登录页未跳转。✅ 可能原因与解决方案(基于知识库)
1. 首页未正确配置或加载失败
pages.json中pages数组的第一个页面是否为真实的首页(如登录页)。tabBar.list中第一个 pagePath 与首页一致。2. App Store 审核环境与本地环境差异
onLaunch或首页onLoad中没有使用未定义的变量或异步阻塞逻辑。3. 路由跳转失败
uni.reLaunch或uni.navigateTo跳转。onLaunch中:4. 白屏问题与版本相关
✅ 推荐排查步骤(按优先级)
pages.json首页配置onLaunch是否有报错✅ 补充建议
如需进一步协助,建议你在 DCloud 社区 发帖,附上
pages.json和App.vue的onLaunch代码片段,官方会协助定位。要回复问题请先登录或注册
公告
更多>相关问题