o***@gmail.com
o***@gmail.com
  • 发布:13 分钟前
  • 更新:13 分钟前
  • 阅读:12

【报Bug】uni-app 微信小程序在安卓上首次进入时上下出现黑带,点「重新进入小程序」后恢复

分类:uni-app

产品分类: 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. 页面内容可以正常显示,但顶部和底部各有一条黑带(图 1)。
  3. 不改任何手机设置,点击右上角「… → 重新进入小程序」,回到同一页面。顶部和底部的黑带消失(图 2)。
  4. 只要不发布新版本,之后再打开都保持正常;再次发布新版本后,首次进入时又会出现黑边。

预期结果: 发布新版本后,首次打开和手动重新进入时的显示一致,上下都不出现额外黑带。

补充观察

  • 手机处于暗色模式时,有时页面顶部是白底,但系统状态栏的时间、信号和电量图标仍是白色,几乎看不见(图 3)。不确定这和上下黑带是不是同一个问题。
  • 我的项目已经重新构建并上传过一版验证,问题仍然会出现。

想请教

  1. 有没有人遇到过「发布新版本后首次打开有黑边,手动重进后一直正常,直到下次发布又复现」的情况?
  2. 同一台手机上的库迪咖啡、瑞幸咖啡、滴滴打车、美团外卖、中油好客 e 站、也有类似黑边。怎么判断这是小程序页面的布局或背景问题,还是微信客户端与 Android 系统栏交界处的显示问题?
  3. 从 uni-app 侧排查的话,应该先看编译后的 app.json 和页面 .json 里的哪些字段?或者记录哪些真机数据,方便对比新版本首次打开和手动重进后的状态?

截图

  • 图 1:发布新版本后首次进入,上下有黑带
  • 图 2:同一页面,点「重新进入小程序」后黑带消失
  • 图 3:暗色模式下,白底上的系统状态栏白字和白色图标几乎看不见
13 分钟前 负责人:无 分享
已邀请:

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