我愿你知道
我愿你知道
  • 发布:2026-06-05 10:04
  • 更新:2026-06-05 10:05
  • 阅读:31

【报Bug】HX升级到5.07,官方的自定义useragent ‘uni-app’ 标识的消失了

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Windows

PC开发环境操作系统版本号: 19045.6332

HBuilderX类型: 正式

HBuilderX版本号: 5.07

手机系统: Android

手机系统版本号: Android 16

手机厂商: 小米

手机机型: 小米17

页面类型: vue

vue版本: vue3

打包方式: 云端

项目创建方式: HBuilderX

操作步骤:

HX升级到 5.07 打包安卓自定义基座,使用web-view访问另一个前端页面,前端页面输出 navigator.userAgent。未看到官方的自定义useragent ‘uni-app’ 标识。

预期结果:

应该显示 uni-app 标识

实际结果:

没有正常显示

bug描述:

打包安卓自定义基座,使用web-view访问另一个前端页面,官方的自定义useragent ‘uni-app’ 标识的消失了。
现在的值是:Mozi11a/5.0 (Linux; Android 16; 2509FPN0BC Build/BP2A.250605.031.A3;wv) AppleWebKit/537.36 (KHTML,like Gecko) Version/4.0 Chrome/140.0.7339.207 Mobile Safari/537.36(Immersed/48.0) Html5Plus/1.0

2026-06-05 10:04 负责人:无 分享
已邀请:
Ask小助手

Ask小助手 - Ask社区AI助手

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

好的,我们来评审一下这个 bug 反馈。

反馈内容评审

这个反馈的整体质量不错,问题描述清晰,核心诉求明确:HBuilderX 升级到 5.07 后,安卓端 web-view 的 User Agent 里,官方默认应添加的 uni-app 标识消失了。

不过在完整性上,有几个地方可以优化:

  1. 缺少代码示例:反馈中描述了使用 web-view 访问页面后,在目标页面通过 navigator.userAgent 获取 UA。如果能附上一段简短的、展示 web-view 用法的代码,以及目标页面的输出代码,会更有说服力。
  2. 复现步骤可以更具体:可以补充一下,是打包了自定义基座后运行发现的问题,还是直接使用标准基座运行就出现了。虽然提到了“打包安卓自定义基座”,但明确说明“使用自定义基座运行”这个步骤会更清晰。
  3. 实际结果值得商榷:从反馈的 UA 信息来看,末尾有 Html5Plus/1.0 这个标识。根据官方文档,默认的 User Agent 会同时包含 Html5Plus/1.0uni-app 两个字段。因此,uni-app 标识的消失,确实可以被视为一个与文档描述不符的问题,不像是误报。

Bug 成立性分析

这个 Bug 是成立的,并且已经是一个已知问题。

根据知识库中的信息,在 HBuilderX 5.0 版本后,出现了一个导致自定义 useragent 获取返回值异常的 Bug。这个 Bug 已经被官方确认,并在 HBuilderX 5.05.2026032417 版本中修复。相关的修复记录在 Android 离线SDK发布历史ask社区问题 #218717 中都有提及。

你当前使用的版本是 5.07,这个版本号高于修复版本 5.05,理论上应该已经包含了此修复。但另一个更新的反馈 ask社区问题 #219383 显示,在 5.07 版本中,仍然有开发者遇到了无法获取到 manifest.json 中自定义 useragent 的问题,这与你反馈的默认 uni-app 标识消失的问题,可能同属于 User Agent 相关的回归问题。

结论与建议

综合来看,这不是一个基本概念问题,而是 HBuilderX 特定版本下的一个真实问题。

建议你尝试以下排查步骤

  1. 确认基座版本:请确保你手机上的自定义基座,是在升级到 HBuilderX 5.07 之后重新制作的。旧版基座是不会随 HBuilderX 升级而更新的,这是最常见的原因之一。相关说明可以参考官方文档
  2. 检查配置:如果基座已更新,请检查 manifest.jsonapp-plus 下的 useragent 配置,确保没有因为误操作将 concatenate 设置为 false 而完全替换了默认 UA,导致包括 uni-app 在内的所有字段都丢失了。
  3. 关注后续版本:如果确认上述步骤无误后问题依旧,这可能是 5.07 版本的一个新问题。建议你关注 HBuilderX 的更新日志,看看下一个版本是否会修复此问题。同时,你也可以考虑回退到 5.05 等已确认修复此问题的版本进行打包测试。
内容为 AI 生成,仅供参考

要回复问题请先登录注册