打包成app，ios上架应用商店审核被拒：白屏

分类：uni-app

iOS打包 uniapp bug已确认

程序分别打包成安卓包和ios包，安卓包正常使用，ios包在安装到手机上也正常打开，问题再想上架ios的AppStore，一直被拒，具体原因就说是白屏，白屏中可以看到有底部tab栏，然后持续处于这个页面，没有跳转到我的程序的登录页，这个tab栏是uni自带的默认tab栏（可以切换，切换页面也一直是空白，只有底部tab各icon的切换状态变更），程序中执行了uni.hideTabBar用于隐藏默认tab然后使用自定义的tab，但是估计没有走到那一步，甚至没有跳转到登录页；

2026-02-26 15:13 负责人:无分享

3 个回复

Ask小助手

欢迎到专业群（ 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 页面。
解决：
- 登录页不应配置为 tabBar 页面，应使用 uni.reLaunch 或 uni.navigateTo 跳转。
- 若首页是 tabBar 页面，登录页应为独立页面，跳转逻辑写在 onLaunch 中：
```
onLaunch() {  
const token = uni.getStorageSync('token');  
if (!token) {  
uni.reLaunch({ url: '/pages/login/index' });  
}  
}  
```

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 代码片段，官方会协助定位。

内容为 AI 生成，仅供参考

DCloud_heavensoft

使用的WGT吗？

2026-02-28 00:13 分享

f***@163.com (作者)

使用的云打包，打完的包放到蒲公英上，然后ios二维码下载一切正常，但是切换证书（其他不变），打完的这个包ios审核就被拒

2026-02-28 08:41
hhafeng

回复 f***@163.com: IOS26.4以上版本，就会出现。其他版本都不会有问题。

2026-06-08 11:16
hhafeng

回复 f***@163.com: 你最后是怎么解决的？

2026-06-08 11:17
DCloud_heavensoft

回复 hhafeng: 如果你能复现，就可以在真机运行时看日志，看看有什么报错导致白屏

2026-06-12 07:25
hhafeng

回复 DCloud_heavensoft: IOS26.4及以上版本，pages.json文件过大时会出现首页白屏，目前是1500行左右，300个页面。把pages.json中的页面减少到一定数量，报错几率就会降低。几十个页面的pages.json基本就不会报错。还有其他版本的IOS和安卓都不会报错。报错代码如下：

17:00:39.041 ReferenceError: Can't find variable: __uniConfig

17:00:39.041 TypeError: r[t] is not a function. (In 'r[t]()', 'r[t]' is undefined)

17:00:39.041 TypeError: undefined is not an object (evaluating 'r.addVData')

17:00:39.041 TypeError: undefined is not an object (evaluating 'r.updateVData')

17:00:39.041 page is not ready

17:00:39.041 TypeError: undefined is not an object (evaluating 't.matches')

17:00:39.041 TypeError: undefined is not an object (evaluating 'r.updateVData')

17:00:39.041 TypeError: undefined is not an object (evaluating 'r.updateVData')

2026-06-12 14:16
hhafeng

回复 DCloud_heavensoft: 社区中已经有不少有反应了这个问题。反正我经过多轮的测试，发现就是IOS26.4以上版本会出现，怀疑是ios26.4+版本WKWebView做了什么加载优化。而且是页面比较多会出现，页面少不会出现。unpackage\dist\dev\app-plus\app-view.js文件超过20m以上，就会有几率出现，这个文件越大，白屏概率越大。

https://ask.dcloud.net.cn/question/219812

https://ask.dcloud.net.cn/question/219126

https://ask.dcloud.net.cn/question/219941

https://ask.dcloud.net.cn/question/219032

2026-06-12 14:24
DCloud_heavensoft

回复 hhafeng: 你能提一个重现项目吗？有300多页面的，我们看看怎么分析解决

2026-06-12 20:47
hhafeng

回复 DCloud_heavensoft: 我空的时候，整理一个发给你

2026-06-13 08:28
hhafeng

回复 DCloud_heavensoft: 你可以用这个项目测试，苹果IOS26.4以上，首页会报错白屏。pages.json页面减少到一定数量，白屏概率会降低。

https://mp-46d0401e-422c-423c-8d5b-ebcd88c62e58.cdn.bspapp.com/苹果测试项目.zip

2026-06-13 10:52
hhafeng

回复 DCloud_heavensoft: https://mp-46d0401e-422c-423c-8d5b-ebcd88c62e58.cdn.bspapp.com/iosdemo.zip

2026-06-13 10:54
DCloud_iOS_XHY

回复 hhafeng: 我使用这个demo测试没有复现出来，我给你发私信了你看一下

2026-06-15 18:07
hhafeng

回复 DCloud_iOS_XHY: 恩恩，我们私聊。

2026-06-16 09:14

DCloud_heavensoft

问题已确认，某些代码的执行在某些情况下会变快，造成时序问题。抱歉给大家造成烦恼，下个版本会修复，请关注更新。

2026-06-16 20:46 分享

要回复问题请先登录或注册

打包成app，ios上架应用商店审核被拒：白屏