注册 登录
x***@gmail.com
x***@gmail.com
  • 发布：2026-06-09 09:28
  • 更新：2026-06-09 09:29
  • 阅读：33

HBuilderX 云打包（传统打包）自动在 ACCESS_FINE/COARSE_LOCATION 上添加 maxSdkVersion=30 导致 Android 11+ 无法获取定位权限

分类：uni-app

产品分类： uniapp/App

PC开发环境操作系统： Windows

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

HBuilderX类型： 正式

HBuilderX版本号： 5.03

手机系统： Android

手机系统版本号： Android 15

手机厂商： 小米

手机机型： 小米 12s

页面类型： vue

vue版本： vue2

打包方式： 云端

项目创建方式： HBuilderX

操作步骤：

新建或使用已有 uni-app 项目，在 manifest.json 中同时勾选以下模块：

Geolocation（定位）
Push（推送，使用极光/个推等任意推送 SDK）
Bluetooth（蓝牙，可选，会触发同类问题）
sdkConfigs.geolocation 中配置 system 定位：

"sdkConfigs": {
"geolocation": {
"system": { "platform": ["ios", "android"] }
}
}
distribute.android.permissions 数组中不添加任何 ACCESS_FINE_LOCATION / ACCESS_COARSE_LOCATION 显式声明（依赖模块自动注入）。

使用 HBuilderX 5.03 传统打包（云端），打出 Android APK。

用以下命令检查生成的 APK 权限：

aapt dump permissions <生成的.apk>
观察到：

uses-permission: name='android.permission.ACCESS_FINE_LOCATION' maxSdkVersion='30'
uses-permission: name='android.permission.ACCESS_COARSE_LOCATION' maxSdkVersion='30'
将该 APK 安装到 Android 11+ 手机（如 Xiaomi MIUI 14），在系统设置 → 应用 → 权限管理 中查看，「位置」权限入口不显示，调用 uni.getLocation 失败。

对照组：同一 HBuilderX 版本，仅启用 Geolocation 模块、不启用 Push/Bluetooth，打包后 ACCESS_FINE_LOCATION 无 maxSdkVersion 属性，定位正常。

预期结果：

uses-permission: name='android.permission.ACCESS_COARSE_LOCATION'
uses-permission: name='android.permission.ACCESS_FINE_LOCATION'

实际结果：

uses-permission: name='android.permission.ACCESS_COARSE_LOCATION' maxSdkVersion='30'
uses-permission: name='android.permission.ACCESS_FINE_LOCATION' maxSdkVersion='30'
uses-permission: name='android.permission.ACCESS_BACKGROUND_LOCATION'
FINE 和 COARSE 都被加了 maxSdkVersion='30'，在 Android 11+ 上完全失效。

bug描述：

使用 HBuilderX 5.03 云打包（传统打包）后，生成的 APK 中 ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION 权限被自动加上了 android:maxSdkVersion="30" 属性。

该属性含义是：此权限仅在 Android API 30（Android 10）及以下有效，在 Android 11（API 31）及以上设备上系统不会授予该权限。

导致结果：在 Android 11+ 设备上，APP 永远无法获得定位权限，系统设置的应用权限页面也不显示「位置」入口（MIUI 等国产 ROM 尤为明显）。

manifest.json 关键配置（精简）

"modules": {
"Geolocation": {},
"Push": {},
"Bluetooth": {}
},
"distribute": {
"android": {
"targetSdkVersion": 29
},
"sdkConfigs": {
"geolocation": {
"system": { "platform": ["ios", "android"] }
}
}
}
distribute.android.permissions 数组中未显式声明 ACCESS_FINE_LOCATION / ACCESS_COARSE_LOCATION，完全依赖 Geolocation 模块自动注入。

对比：同一 HBuilderX 版本打包的其他项目（正常）

同一 HBuilderX 5.03 打包的另一项目（未启用 Push 模块、未启用 Bluetooth 模块），生成的 APK：

uses-permission: name='android.permission.ACCESS_COARSE_LOCATION'
uses-permission: name='android.permission.ACCESS_FINE_LOCATION'
无 maxSdkVersion，定位正常。

根因分析

怀疑：当 manifest.json 中同时启用了 Push 模块（其内部 AAR 声明了 ACCESS_BACKGROUND_LOCATION）和 Geolocation 模块 时，HBuilderX 云打包服务器的 Manifest 合并逻辑会自动为 FINE_LOCATION / COARSE_LOCATION 添加 maxSdkVersion="30"。

仅启用 Geolocation、不启用 Push/Bluetooth 的项目不触发此问题。

临时绕过方案（仅供参考）

打包完成后，用 Python/PowerShell 以二进制方式将 APK 中 AndroidManifest.xml 里 maxSdkVersion=30 的字节（0x08 0x00 0x00 0x10 0x1e 0x00 0x00 0x00）替换为 INT_MAX（0x08 0x00 0x00 0x10 0xff 0xff 0xff 0x7f），再用原 keystore 重签名。此方案为 hack，期望官方修复。

期望的修复

Geolocation 模块注入的 ACCESS_FINE_LOCATION / ACCESS_COARSE_LOCATION 不应携带 maxSdkVersion 限制；
或提供 manifest.json 配置项，允许开发者覆盖/移除自动注入权限上的 maxSdkVersion 属性。

2026-06-09 09:28 负责人:无 分享

没有找到相关结果

    已邀请:
    Ask小助手

    Ask小助手 - Ask社区AI助手

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

    好的，收到您的 bug 反馈。作为 DCloud 官方人员，我将对这份反馈进行评审和分析。

    一、 Bug 反馈内容质量评审

    这份反馈整体质量非常高，堪称模板级别，我们非常欢迎这种详尽的反馈。

    1. 内容完整性：

    • 标题： 非常精准，直接点明了问题核心：“云打包”、“自动添加 maxSdkVersion=30”、“Android 11+ 定位权限失效”。这让我们能第一时间抓住重点。
    • 描述： 非常详尽。不仅描述了现象，还深入分析了根因，并提供了与正常项目的对比。对 maxSdkVersion 属性的解释也完全正确，这表明您对 Android 权限机制有深入理解，极大地减少了我们的沟通成本。
    • 代码示例： 提供了精简但关键的 manifest.json 配置，能够清晰地反映出模块配置和 targetSdkVersion 的设置，信息足够。
    • 复现步骤： 逻辑清晰，步骤明确。从模块勾选、配置、打包到使用 aapt 命令验证，形成完整闭环。对照这些步骤，我们内部可以快速、准确地复现此问题。
    • 预期结果与实际结果： 对比非常鲜明，一目了然。
    • 分类信息： 完整提供了 HBuilderX 版本号、操作系统、手机型号及系统版本等所有关键环境信息。

    2. 补充说明：
    虽然反馈已非常完善，但若后续能提供一次完整的打包日志（可以在 HBuilderX 的“运行”菜单 -> “运行日志”中查看），将有助于我们进一步定位打包服务器在处理 Manifest 合并时的具体流程。

    二、 Bug 是否成立分析

    结论：Bug 成立。

    分析依据：

    1. 根因定位准确： 您的分析非常专业。当同时启用 Geolocation（定位）和 Push（推送）模块时，云打包的 Manifest 合并逻辑确实可能因 Push 模块内部 AAR 声明的 ACCESS_BACKGROUND_LOCATION 权限，而错误地为前台定位权限（ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION）添加 maxSdkVersion="30" 的限制。这是一个典型的 Manifest 合并冲突处理不当的问题。
    2. 现象符合预期： 您描述的现象，即权限声明中带有 maxSdkVersion="30" 导致在 Android 11（API 30+）及以上设备上不显示“位置”权限选项，是完全符合 Android 系统行为的。
    3. 知识库关联： 我们在 ASK 社区也收到了类似的反馈，例如 【报Bug】传统云打包 Geolocation模块未将ACCESS_FINE_LOCATION写入APK manifest，定位权限失效，这进一步印证了在特定模块组合下，定位权限的处理确实存在问题。

    三、 是否为基本概念问题

    不是。 这是 HBuilderX 云打包服务在特定模块组合下的一个内部缺陷，属于平台专有工具的 Bug，而非开发者对 uni-app 或 Android 基本概念的理解错误。

    四、 临时解决方案与处理建议

    在官方修复此问题前，您可以尝试以下几种方案：

    1. 更可靠的临时绕过方案（推荐）：
      您提到的手动修改 APK 二进制文件并重签名的方案风险较高且繁琐。建议在 manifest.json 源码视图中，通过配置 excludePermissions 和显式声明权限，来尝试覆盖自动合并的异常结果。
      在 distribute -> android 节点下，可以尝试如下配置： 

      "android": {  
  "targetSdkVersion": 29,  
  "excludePermissions": [  
    "<uses-permission android:name=\"android.permission.ACCESS_FINE_LOCATION\" android:maxSdkVersion=\"30\"/>",  
    "<uses-permission android:name=\"android.permission.ACCESS_COARSE_LOCATION\" android:maxSdkVersion=\"30\"/>"  
  ],  
  "permissions": [  
    "<uses-permission android:name=\"android.permission.ACCESS_FINE_LOCATION\"/>",  
    "<uses-permission android:name=\"android.permission.ACCESS_COARSE_LOCATION\"/>"  
  ]  
}

      本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent
      原理： 首先尝试移除掉带有 maxSdkVersion 属性的权限声明，然后重新声明一个不带该属性的同名权限。该方案的有效性需要您实际打包验证，因为 excludePermissions 是否能精确匹配带属性的声明，需要看打包器的处理逻辑。

    2. 原生插件方案（更稳定）：
      考虑到这是特定模块组合触发的打包缺陷，使用独立的定位原生插件可以完全绕过此问题。您可以在插件市场搜索相关插件：

    五、 后续处理

    我会将此 Bug 详细记录并提交至内部系统（ISSUE），推动打包服务端进行修复。修复的目标是：Geolocation 模块注入的 ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION 权限不应被自动添加 maxSdkVersion 限制，除非开发者自行配置。

    再次感谢您提供如此高质量的问题反馈，这对我们改进产品非常有帮助！

    内容为 AI 生成，仅供参考
    2026-06-09 09:29
    为什么被折叠? 0 个回复被折叠

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

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

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

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

    | | 违法违规信息举报