注册 登录
7***@qq.com
7***@qq.com
  • 发布：2026-10-27 17:11
  • 更新：2026-10-27 17:12
  • 阅读：71

【报Bug】进入页面白屏

分类：uni-app

产品分类： uniapp/App

PC开发环境操作系统： Windows

PC开发环境操作系统版本号： 22H2

HBuilderX类型： 正式

HBuilderX版本号： 5.26

手机系统： Android

手机系统版本号： Android 5.1

手机厂商： newland

手机机型： NLS-MT66

页面类型： vue

vue版本： vue2

打包方式： 云端

项目创建方式： HBuilderX

操作步骤：

测试1：

  1. 菜单选择 文件-新建-项目
  2. 选择 uni-app 选择第一个默认模版
  3. 进行云打包
  4. 手机安装
    小米17 正常进入 android 5.1手机进入白屏
    测试2：
  5. 增加 "minSdkVersion" : 21
    2 云打包
    android 5.1手机进入白屏

预期结果：

正常进入app

实际结果：

进入白屏

bug描述：

之前使用 HBuilder X 4.66 版本正常，切换到 HBuilder X 5.26 版本后出现。
都是使用云端打包
下载之前版本4.66 版本打包还是白屏。自测了很多参数修改无效。

使用5.26 版本官方demo 可复现。

2026-10-27 17:11 负责人:无 分享

没有找到相关结果

    已邀请:
    Ask小助手

    Ask小助手 - Ask社区AI助手

    欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

    收到你的 bug 反馈，以下是我以官方视角对这条反馈的评审意见：

    一、反馈完整性评审

    做得好的地方：

    1. 复现步骤清晰且复现成本低：明确说明使用 HBuilderX 新建 uni-app 默认模板 + 云打包即可复现，并给出“小米17（高版本 Android）正常、Android 5.1 白屏”的对照结论。这意味着官方可以直接用默认模板复现，无需依赖你的业务代码，是本次反馈最有价值的信息。
    2. 分类信息完整：操作系统（Windows 22H2）、HBuilderX 版本（5.26 正式版）、手机系统（Android 5.1）、厂商机型（newland NLS-MT66）、Vue 版本（Vue2）、打包方式（云端）齐全。
    3. 做了版本回退和参数修改的对比测试，排查思路清晰。

    需要补充/澄清的信息（我无法识别附件，请以文字/链接形式补充）：

    1. 白屏时的运行日志：白屏问题没有日志基本无法定位根因。请在 Android 5.1 设备复现白屏后抓取 logcat 日志并以文本形式贴出，重点关注是否有 JS 语法错误（如 SyntaxError）、createInstanceContext 失败等异常堆栈。
    2. 设备的 WebView 内核版本：Android 5.1 属于低版本系统，其系统 WebView 内核版本通常较低。请在设备“设置-应用”中查看 Android System WebView 的版本号并补充。低版本 webview 与启动白屏的关联在官方更新记录中有体现——HBuilderX 3.6.13 更新说明中提到“优化 Vue3 项目 minUserAgentVersion 默认配置为 49，避免低版本webview上白屏无提示”（查看）。
    3. “回退 4.66 打包还是白屏”需要澄清：你之前用 4.66 打包在该设备上是正常的，现在回退 4.66 重新打包却白屏，两者矛盾。请确认：之前 4.66 打包的旧 apk 现在在这台设备上是否仍然正常？回退后打包的 apk 是否卸载后重装？这有助于判断是云端打包产物变化还是设备端环境（如 webview）变化导致。
    4. 白屏的具体表现：是卡在启动图后白屏，还是进入首页后白屏？底部 tabBar/导航栏是否显示？另外请补充：使用标准基座“真机运行”到这台 Android 5.1 设备是否也白屏？
    5. 如方便，请提供白屏 apk 的下载地址（链接形式即可），便于直接安装验证。

    二、bug 成立性分析

    从知识库看，该反馈大概率成立，且与“低版本 Android 设备”场景高度相关：

    1. ask 社区有多条 Android 5.1 设备云打包后启动白屏的历史反馈，现象与你一致（高版本设备正常、低版本设备白屏）：
    2. ISSUE 系统中有类似现象的线索：低版本系统上运行新版编译产物时报 SyntaxError: Unexpected token '?'（低版本 JS 引擎不支持新语法）导致启动白屏（ISSUE 系统，该 issue 为待确认状态，仅作线索参考）。这说明新版编译产物若包含低版本 JS 引擎不支持的语法，就会在老设备上白屏，与你“5.26 打包后 Android 5.1 白屏、新系统设备正常”的现象模式吻合。
    3. 关于测试 2 中增加 "minSdkVersion": 21：minSdkVersion 属于 Android 构建层面的最低系统版本声明，知识库中暂未找到通过修改该参数解决此类白屏的依据，该测试无效属正常，不能作为问题方向的判断依据。

    综合结论：使用官方默认模板在 5.26 云打包后 Android 5.1 白屏、高版本 Android 正常，说明问题与你的业务代码无关，属于新版编译产物在 Android 5.1 低版本环境下的兼容性问题，bug 反馈有效。但具体根因（哪条语法/哪个模块不兼容）必须依赖上述日志和设备 webview 版本信息才能确认，请补充后我们再进一步排查。

    如需继续跟进，建议在 DCloud 问答社区 该帖下直接补充上述信息，便于官方人员持续跟进处理。

    内容为 AI 生成，仅供参考
    2026-10-27 17:12
    为什么被折叠? 0 个回复被折叠

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

    退出全屏模式 全屏模式 回复
    友情链接
    优势智云 黑马程序员 程序员客栈 个推 锐亚教育 即速应用 DCloud新闻 InfoQ 蓝莺IM HeapDump性能社区 diygw可视化 艾普阳科技 申请友链

    DCloud 即数字天堂(北京)网络技术有限公司是W3C成员及HTML5中国产业联盟发起单位

    京ICP备12046007号-4 | 京公网安备：11010802035340号 | 国家信息安全等级保护三级，证书编号：11010813802-20001

    | | 违法违规信息举报