目录

访问控制错误码

以下仅介绍本模块特有错误码,通用错误码请参考通用错误码说明文档。

12100001 入参错误

错误信息

Invalid Parameter. Error message: messageInfo.

错误描述

当入参错误时,将返回该错误码。

可能原因

  1. tokenId值为0。
  2. 指定的权限名为空或者权限名长度大于256。
  3. 请求授权/撤销权限的flag取值非法。
  4. 注册监听的参数检查错误。
  5. 指定的Context不属于当前应用。
  6. 请求的权限不属于同一个权限组。
  7. 请求的权限中存在应用未声明的权限。
  8. 请求的全局开关类型非法。
  9. 指定的权限名不是user_grant权限。
  10. 指定的数组成员个数超过1024或成员均为无效值。
  11. 请求查看权限使用记录的起始结束时间不合法。
  12. 指定的权限名未在应用中声明。

处理步骤

检查入参,修正参数值为有效值,有效值请参考@ohos.abilityAccessCtrl (程序访问控制管理)中对应接口的参数说明。

12100004 接口未配套使用

错误信息

The API is not used in pair with others.

错误描述

当接口未按配套关系调用,或在未解除配套关系前重复调用时,将返回该错误码。

可能原因

  1. 当前接口在未解除配套关系前,使用相同入参重复调用。
  2. 当前接口在未配套使用的情况下,单独调用。

处理步骤

检查当前接口是否有配套使用:

相关方法:

12100005 监听器数量超过限制

错误信息

The number of listeners exceeds the limit.

错误描述

当监听器数量超过限制时,将返回该错误码。

可能原因

注册的监听器数量超过系统限制的200个上限。

处理步骤

及时释放已注册的无用的监听器。

12100007 系统服务工作异常

错误信息

Service exception.

错误描述

当系统服务工作异常时,将返回该错误码。

可能原因

  1. 权限管理服务无法正常启动。
  2. IPC(Inter-Process Communication,进程间通信)数据读取写入失败。

处理步骤

系统服务内部工作异常,请稍后重试,或者重启设备。

12100009 服务内部错误

错误信息

Common inner error.

错误描述

当服务内部发生错误或权限弹窗发生错误时,将返回该错误码。

可能原因

  1. 内部错误
    • 系统服务内部异常或数据库错误。
  2. 权限弹窗错误
    • 应用处于后台,无法正常拉起弹窗。
    • 设备处于锁屏状态,无法正常弹出弹窗。
    • 拉起弹窗后未及时处理,弹窗进程因应用退出而被系统回收,例如用户在多任务界面清理应用进程。

处理步骤

  1. 内部错误
    • 建议重启设备后重试。
  2. 权限弹窗错误
    • 确认应用处于前台状态后再发起弹窗请求。
    • 确认设备处于解锁状态后再发起弹窗请求。
    • 确认弹窗已被及时处理,若弹窗进程因应用退出而被系统回收则无需额外操作。
  3. 若问题仍无法解决,请开发者通过在线提交工单反馈问题说明及日志信息,技术支持人员会及时处理。

12100010 存在未被处理的请求

错误信息

The request already exists.

错误描述

当存在未被处理的请求时,将返回该错误码。

可能原因

上一次请求未被处理。

处理步骤

请等待上一次权限请求完成,并根据上一次请求的返回结果完成授权处理后再重新发起请求。

12100011 输入的所有权限均已被授权

错误信息

All permissions in the permission list have been granted.

错误描述

当输入的所有权限均已被授权时,将返回该错误码。

可能原因

所有权限均已被授权。

处理步骤

无需处理,返回此错误码表示申请权限已被授权,不会弹出权限设置弹窗。

12100012 输入的权限中存在未被用户拒绝过的权限

错误信息

The permission list contains the permission that has not been revoked by the user.

错误描述

当输入的权限中存在未被用户拒绝过的权限时,将返回该错误码。

可能原因

存在未被用户拒绝过的权限。

处理步骤

请先调用requestPermissionsFromUser向用户申请权限。

12100013 全局开关已开启

错误信息

The specific global switch is already open.

错误描述

当全局开关已开启时,将返回该错误码。

可能原因

全局开关已开启。

处理步骤

无需处理,返回此错误码表示全局开关已开启,不会弹出全局开关设置弹窗。

12100014 非预期的权限

错误信息

Unexpected permission.

错误描述

当输入的权限不符合使用场景时,将返回该错误码。

可能原因

  1. 调用requestPermissionOnSetting再次弹出权限设置弹窗时,传入了manual_settings授权方式的权限。
  2. 授权或取消授权时,传入了非user_grant和manual_settings授权方式的权限。
  3. 调用openPermissionOnSetting拉起跳转设置页弹窗时,传入了非manual_settings授权方式的权限。

处理步骤

请确认输入的权限是否符合使用场景。