木子HarmonyOS 5
Unsupported restricted ACL permission exist in the configuration
中华神刃这个报错 Unsupported restricted ACL permission exist in the configuration,说白了就是自动签名有白名单限制,你在module.json5里写的某个ACL权限,不在当前IDE版本自动签名允许的权限清单里,自动签名打包校验直接拦下来。
先讲排查顺序:
- 打开module.json5,找到requestPermissions,把里面声明的权限一条一条摘出来核对。
- 对照官网自动签名可开放ACL权限清单,看哪个权限不在支持列表里。
- 两种处理方式:不需要这个权限就直接删掉;业务必须要用,就不能走自动签名,改成手动签名流程。
这里有几个容易踩的点:
- 调试阶段跑起来不会校验这个,只有勾选自动签名打包的时候才报这个错,很多人本地调试没事,打包才翻车。
- 不同DevEco Studio版本支持的权限清单不一样,新版本会新增一部分受限ACL,版本低的IDE不认。
- 就算你在AGC后台申请好了权限,只要走自动签名,依然受白名单约束,不是AGC批了就能用。
- 自动签名和手动签名是两套东西,自动签名只能用固定子集,受限权限统一走手动签名。
给你个示例,就是module.json5权限声明这块:
"requestPermissions": [
{
"name": "ohos.permission.ACCESS_DDK_USB"
}
]
如果确定这个权限是刚需,手动签名流程简单说下:
- 去AGC提交受限ACL权限申请,写清楚使用场景,等审核通过。
- 申请Profile的时候勾选上已经获批的受限ACL,下载新的Profile。
- DevEco Studio里切换成手动配置签名信息,把证书、密钥、Profile配进去再打包。
还有一个小提醒:不要随便加权限,很多时候是复制别人配置的时候带进来多余的ACL,删掉没用的权限,报错直接就消失了。
大雷神先定位“哪一条权限不被当前自动签名流程支持”,不要直接把它当成用户拒绝授权,也不要仅切换手动签名就认为权限已获批。
建议列一张最小清单:DevEco Studio完整版本、工程声明的每个受限权限、该权限对应的实际功能。对照与你IDE版本匹配的自动签名支持列表逐项检查。官方说明从6.1.0 Beta2开始,自动签名可配置的ACL权限参考“受限开放权限”;旧版则需核对对应版本清单:
https://developer.huawei.com/consumer/cn/doc/HarmonyOS-Guides/ide-signing-auto/
具体排查可这样做:
1. 在本地备份/分支中,把不确定的受限权限逐项移除并重新尝试签名,只用于定位触发项。找到后再决定是否删去依赖该权限的功能、改用官方替代方案,或走相应申请流程;不要删了声明却保留原来的受限接口调用。
2. 如果权限来自复制的示例或三方组件,追到实际使用点,确认当前功能确实需要它。不要凭一个报错额外加入更多ACL权限。
3. 手动签名需要对应应用、证书和含目标权限的Profile。已有一份旧Profile,不能证明新增权限也已包含;修改权限后要核对实际用于当前构建的Profile。
4. 受限权限还要满足官方列出的应用场景和主体要求。升级IDE可能改变支持清单,但不能把本不开放给该应用场景的权限变为可申请。
调试和发布也要分开:官方允许调试阶段通过符合条件的自动签名申请;发布阶段仍须在申请发布Profile时手动申请相应受限权限。签名配置通过,也不能替代user_grant权限的运行时授权。
https://developer.huawei.com/consumer/cn/doc/HarmonyOS-Guides/declare-permissions-in-acl/
你贴出具体权限名称及IDE版本后,才能判断是版本清单问题、权限选型问题,还是需要走申请流程。目前没有这些信息,不能确定是哪一项,更不能保证改成手动签名就成功。
AI助手该报错的原因是:DevEco Studio 的自动签名功能只支持申请一份固定的 ACL 权限清单,而您的工程在 module.json5 的 requestPermissions 中声明了不在该清单范围内的受限 ACL 权限,因此自动签名在向 AGC 申请 Profile 文件时校验失败,弹出“Unsupported restricted ACL permission exist in the configuration”提示。
原因分析
自动签名的工作机制是:DevEco Studio 会校验当前工程配置的所有 ACL 权限,确认其是否在“自动签名支持的 ACL 权限”清单内,校验通过后才通过 AGC 自动申请 Profile 文件用于签名打包。一旦工程中存在清单之外的受限权限(例如部分 system_core 级别或需特殊审批的权限),自动签名即会中止并报此错误。
自动签名支持的 ACL 权限清单随 DevEco Studio 版本逐步扩充,例如 5.0.0 Release 支持的权限包括 ohos.permission.READ_CONTACTS、ohos.permission.READ_IMAGEVIDEO、ohos.permission.ACCESS_DDK_USB、ohos.permission.SYSTEM_FLOAT_WINDOW 等;后续版本又陆续新增了 ohos.permission.CUSTOM_SCREEN_RECORDING、ohos.permission.MANAGE_SCREEN_TIME_GUARD 等权限。从 DevEco Studio 6.1.0 Beta2 版本开始,自动签名支持的 ACL 权限范围以官网“受限开放权限”文档为准。
解决措施
方案一:检查并调整权限配置
- 打开报错模块的
module.json5文件,定位到requestPermissions字段,例如:
{
"module": {
"requestPermissions": [
{
"name": "ohos.permission.ACCESS_DDK_USB"
}
]
}
}
- 对照官网“自动签名支持的ACL权限”清单,逐一核对工程中声明的权限。若某个权限不在清单内,且并非业务必需,可将其从
requestPermissions中移除,或替换为同能力的普通权限,再重新执行自动签名。
方案二:改用手动签名
若业务确实需要使用清单之外的受限 ACL 权限,自动签名无法满足,请改用手动签名流程:
- 在 AGC 平台为该受限权限提交“申请使用受限权限”,说明应用的使用场景,等待审核通过;
- 审核通过后,在申请 Profile 文件时勾选“受限ACL权限(HarmonyOS API9及以上)”选项,选中已获批的权限,生成并下载新的 Profile 文件;
- 在 DevEco Studio 中按“手动配置签名信息”的方式,将证书、密钥和 Profile 文件配置到工程的签名配置中,完成签名。
补充说明
- 调试阶段不会强制校验配置文件中添加的 ACL 权限,但自动签名会校验权限是否在支持清单内,两者并不冲突。
- 涉及受限权限的应用上架时,AGC 会根据应用的实际使用场景审核是否可以使用对应受限权限,不符合场景的上架申请将被驳回,因此配置前请先确认应用是否符合受限权限的使用场景。
- 若不确定当前 DevEco Studio 版本支持哪些 ACL 权限,可升级到最新版本后重试自动签名,新版本通常扩充了支持清单。
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
HarmonyOS 华为运动健康获取今日步数Permission verification failed, The app does not have 200009 read permission. (API12+)
HarmonyOS 蓝牙getPairedDevices添加了ohos.permission.ACCESS_BLUETOOTH权限后仍然报错 (API12+)
HarmonyOS 申请权限时报错9568289,通过ACL提权并未成功 (API12+)
HarmonyOS 项目运行报错“install failed due to grant request permissions failed” (API12+)
HarmonyOS 使用saveButton安全控件,保存视频到相册报错“without medialibrary permission” (API12+)
HarmonyOS @ohos.file.photoAccessHelper替换ohos.permission.READ_MEDIA是否符合工信部的隐私等规范,会不会对应用上架造成影响 (API12)
HarmonyOS 端云一体化新建应用项目模板,无法在真机上调用云函数“hmos auth app doesn’t have permission”(API12+)
HarmonyOS 获取了ohos.permission.READ_IMAGEVIDEO权限,但是访问图库仍然报错System inner fail (API12+)




































苏公安网备 32011402010933号