直接进入页面即可复现
- 发布:13 分钟前
- 更新:13 分钟前
- 阅读:12
产品分类: uniapp/小程序/微信
PC开发环境操作系统: Mac
PC开发环境操作系统版本号: macos 27.2
HBuilderX类型: 正式
HBuilderX版本号: 5.34
第三方开发者工具版本号: 2.06.2508042 darwin-arm64
基础库版本号: 3.17.6
项目创建方式: HBuilderX
操作步骤:
预期结果:
应用全屏,状态栏根据页面变换颜色
应用全屏,状态栏根据页面变换颜色
实际结果:
不全屏,无法变换颜色
不全屏,无法变换颜色
bug描述:
uni-app 微信小程序发布新版本后首次进入出现上下黑边,点「重新进入小程序」后恢复
问题描述
我的项目用 uni-app 构建微信小程序。在三星 Galaxy S25 Ultra 上,新版本发布后首次打开小程序时,页面内容能正常显示,但屏幕顶部(时间、电量所在的状态栏附近)和底部(系统导航区附近)各出现一条黑带。点右上角「… → 重新进入小程序」后,黑带消失。在不发布新版本的情况下,之后再打开也一直正常;再次发布新版本后,黑边又会出现。
同一台手机上,霸王茶姬、库迪咖啡、瑞幸咖啡、滴滴打车、美团外卖、中油好客 e 站等微信小程序也都出现过类似的上下黑边,也都是重新进入小程序后恢复为全屏。 我不知道它们用的是什么框架,也没有确认它们的黑边是否同样由版本更新触发。下文的复现步骤是我自己项目里观察到的。
复现环境
- 手机:三星 Galaxy S25 Ultra
- 系统:One UI 8.5
- 微信版本:8.0.76
- Vue:3.4.21
复现步骤
- 发布小程序新版本后,从微信的任意入口首次打开新版本,进入首页。
- 页面内容可以正常显示,但顶部和底部各有一条黑带(图 1)。
- 不改任何手机设置,点击右上角「… → 重新进入小程序」,回到同一页面。顶部和底部的黑带消失(图 2)。
- 只要不发布新版本,之后再打开都保持正常;再次发布新版本后,首次进入时又会出现黑边。
预期结果: 发布新版本后,首次打开和手动重新进入时的显示一致,上下都不出现额外黑带。
补充观察
- 手机处于暗色模式时,有时页面顶部是白底,但系统状态栏的时间、信号和电量图标仍是白色,几乎看不见(图 3)。不确定这和上下黑带是不是同一个问题。
- 我的项目已经重新构建并上传过一版验证,问题仍然会出现。
想请教
- 有没有人遇到过「发布新版本后首次打开有黑边,手动重进后一直正常,直到下次发布又复现」的情况?
- 同一台手机上的库迪咖啡、瑞幸咖啡、滴滴打车、美团外卖、中油好客 e 站、也有类似黑边。怎么判断这是小程序页面的布局或背景问题,还是微信客户端与 Android 系统栏交界处的显示问题?
- 从 uni-app 侧排查的话,应该先看编译后的
app.json和页面.json里的哪些字段?或者记录哪些真机数据,方便对比新版本首次打开和手动重进后的状态?
截图
- 图 1:发布新版本后首次进入,上下有黑带
- 图 2:同一页面,点「重新进入小程序」后黑带消失
- 图 3:暗色模式下,白底上的系统状态栏白字和白色图标几乎看不见