注册 登录
4***@qq.com
4***@qq.com
  • 发布：2026-05-11 15:04
  • 更新：2026-05-11 15:07
  • 阅读：53

【报Bug】ios升级到26.4.2后，用户热更新，app启动白屏，升级了SDK重新打包也是一样，HbuilderX 5.07

分类：uni-app

产品分类： uniapp/App

PC开发环境操作系统： Windows

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

HBuilderX类型： 正式

HBuilderX版本号： 5.07

手机系统： iOS

手机系统版本号： iOS 26

手机厂商： 苹果

手机机型： iphone13

页面类型： vue

vue版本： vue2

打包方式： 离线

项目创建方式： HBuilderX

示例代码：

{
"name" : "com.gdxinyue.wlms",
"appid" : "UNI83024DD",
"description" : "",
"versionName" : "2.2.0",
"versionCode" : 193,
"transformPx" : false,
/ 5+App特有相关 /
"app-plus" : {
"compatible" : {
"ignoreVersion" : true,
"iOS26ViewportFix": true // 新增参数
},
"webviewParameter": {
"viewport": {
"width": "device-width",
"initial-scale": 1.0,
"minimum-scale": 1.0,
"maximum-scale": 1.0,
"user-scalable": false
}
},
"usingComponents" : true,
"nvueStyleCompiler" : "uni-app",
"compilerVersion" : 3,
"splashscreen" : {
"alwaysShowBeforeRender" : true,
"waiting" : false,
"autoclose" : true,
"delay" : 0
},
"softinput" : {
"mode" : "adjustPan"
},
/ 状态栏高度 /// "statusbar" : {
// "immersed" : false
// },
"safearea" : {
"background" : "#FFFFFF",
"bottom" : {
"offset" : "auto"
}
},
/ 模块配置 /
"modules" : {
"Maps" : {},
"Fingerprint" : {},
"VideoPlayer" : {},
"LivePusher" : {}
},
/ 应用发布信息 /
"distribute" : {
/ android打包配置 /
"android" : {
"permissions" : [
"<uses-feature android:name=\"android.hardware.camera\"/>",
"<uses-feature android:name=\"android.hardware.camera.autofocus\"/>",
"<uses-permission android:name=\"android.permission.ACCESS_NETWORK_STATE\"/>",
"<uses-permission android:name=\"android.permission.ACCESS_WIFI_STATE\"/>",
"<uses-permission android:name=\"android.permission.CAMERA\"/>",
"<uses-permission android:name=\"android.permission.CHANGE_NETWORK_STATE\"/>",
"<uses-permission android:name=\"android.permission.CHANGE_WIFI_STATE\"/>",
"<uses-permission android:name=\"android.permission.FLASHLIGHT\"/>",
"<uses-permission android:name=\"android.permission.GET_ACCOUNTS\"/>",
"<uses-permission android:name=\"android.permission.MOUNT_UNMOUNT_FILESYSTEMS\"/>",
"<uses-permission android:name=\"android.permission.READ_LOGS\"/>",
"<uses-permission android:name=\"android.permission.READ_PHONE_STATE\"/>",
"<uses-permission android:name=\"android.permission.RECORD_AUDIO\"/>",
"<uses-permission android:name=\"android.permission.USE_FINGERPRINT\"/>",
"<uses-permission android:name=\"android.permission.VIBRATE\"/>",
"<uses-permission android:name=\"android.permission.WAKE_LOCK\"/>",
"<uses-permission android:name=\"android.permission.WRITE_SETTINGS\"/>"
],
"abiFilters" : [ "armeabi-v7a", "arm64-v8a", "x86" ]
},
/ ios打包配置 /
"ios" : {
"dSYMs" : false,
"idfa" : true,
"privacyDescription" : {
"NSUserTrackingUsageDescription" : "请放心，开启权限不会获取您在其他站点的隐私信息，该权限仅用于标识设备并保障服务安全与提示浏览体验"
}
},
/ SDK配置 /
"sdkConfigs" : {
"maps" : {
"amap" : {
"appkey_ios" : "",
"appkey_android" : "2bac414971326a3c41f125d740d8532a"
}
}
}
}
},
/ 快应用特有相关 /
"quickapp" : {},
/ 小程序特有相关 /
"mp-weixin" : {
"appid" : "wxee00d752415987ec",
"setting" : {
"urlCheck" : false
},
"usingComponents" : true
},
"mp-alipay" : {
"usingComponents" : true
},
"mp-baidu" : {
"usingComponents" : true
},
"mp-toutiao" : {
"usingComponents" : true
},
"uniStatistics" : {
"enable" : false
}
}

操作步骤：

1.卸载重新安装app，热更新
2.重启，出现白屏。
另外一种复现方式：
1.更新xcode和macOS到最新版本，下载最新的SDK，离线打包
2.运行，能正常登录进入
3.杀进程再启动，白屏，是每次都白屏，没法正常使用

预期结果：

能正常使用APP。

实际结果：

启动出现白屏

bug描述：

用户苹果手机升级到ios26.4.2后，热更新app然后启动，app白屏，我用iphone13能复现，重新安装app，热更新然后白屏。我更新xcode，下载最新的SDK，离线打包，运行，能正常登录进入，然后杀进程再启动，白屏，是每次都白屏，没法正常使用。

2026-05-11 15:04 负责人:无 分享

没有找到相关结果

    已邀请:
    Ask小助手

    Ask小助手 - Ask社区AI助手

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

    作为 DCloud 官方人员，我对这份 bug 反馈进行评审如下：

    1. 反馈内容完整性分析

    该反馈整体质量较高，结构清晰，大多数必要元素都已提供。

    • BUG 描述：描述非常详细。不仅指出了问题现象（启动白屏），还提供了关键的上下文信息：触发条件（iOS 26.4.2 系统、热更新）、影响范围（HBuilderX 5.07、iPhone 13），并对比了两种场景（热更新 vs 离线打包），这有助于我们快速锁定问题方向。描述是清晰的，官方人员能够看懂。
    • 代码示例：提供的 manifest.json 配置非常完整且关键。从中可以看到，你已经尝试了已知的兼容性修复方案，例如添加了 "iOS26ViewportFix": true 参数。这使得问题排查可以跳过基础步骤，直接进入更深层次的分析。
    • 复现步骤：描述得非常清晰，提供了两种可操作的路径。路径一（热更新场景）和路径二（离线打包场景）都明确指向了“杀进程重启后白屏”这一共同点。根据这些步骤，官方人员使用对应的设备和系统版本，有极大概率能够成功复现问题。
    • 预期结果：预期结果“能正常使用APP”是完全合理的。
    • 实际结果：“启动出现白屏”这个结果是不正常的，基本可以排除误报。这是一个真实存在的、影响用户体验的严重缺陷。
    • 分类信息：分类信息基本完整，包含了开发环境、HBuilderX 版本、手机 OS 平台及版本、Vue 版本、设备机型等。这些信息对于定位平台特定或版本特定问题至关重要。

    2. Bug 是否成立分析

    Bug 成立。

    根据知识库中的信息，可以找到明确依据。在 ask 社区知识库中，有一个与你的反馈高度相似的问题 [DCloud问答_219189] 【报Bug】iOS 端更新 (iOS 26.4)后出现白屏或页面缩放异常。该问题明确指出在 iOS 26.4 系统上使用 uni-app 会出现白屏或页面缩放异常，且官方已在 5.06 版本中确认了此问题，并提供了在 manifest.json 的 app-plus -> compatible 节点下配置 "iOS26ViewportFix": true 的临时解决方案。

    你的反馈揭示了另一个层面的问题：即使已经添加了 "iOS26ViewportFix": true 这个修复参数，在特定的“热更新”或“离线打包后杀进程重启”的场景下，白屏问题依然存在。 这说明该兼容性修复可能在某些资源加载或初始化时序上仍有疏漏，或者问题比预想的更复杂。

    此外，在对话知识库中，也有用户反馈类似情况，例如“新版本打包后app启动卡死在白屏，老版本打包后的全部正常”。这进一步佐证了此问题与特定版本或打包环境强相关。

    3. 后续建议与排查方向

    基于以上分析，建议你进行以下操作，并将结果补充到原 bug 反馈中，以便我们进一步处理：

    1. 提供日志信息：白屏问题通常伴随 JS 执行错误。建议尝试连接 Xcode 查看应用启动时的完整控制台输出，寻找任何报错信息。如果有条件，复现后通过 Safari 开发者选项连接设备查看 WebView 的 JS 报错日志，这对于定位问题至关重要。
    2. 验证“整包更新”：请尝试使用最新版 SDK 进行整包更新（即通过 App Store 或企业证书分发 .ipa 文件），而非热更新，确认问题是否依然存在。这有助于判断问题是否与 wgt 资源包更新机制有关。
    3. 验证最新 Alpha 版本：在 HBuilderX 5.08 Alpha 版本中重新打包测试，检查问题是否已被修复。

    总体而言，这是一个非常有价值的反馈，清晰地将一个已知问题（iOS 26.4 白屏）延伸到了其修复方案未能覆盖的边缘场景。期待你补充更多调试信息，以便我们彻底解决此问题。

    内容为 AI 生成，仅供参考
    2026-05-11 15:07
    为什么被折叠? 0 个回复被折叠

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

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

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

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

    | | 违法违规信息举报