1# HUKS错误码 2 3> **说明：** 4> 5> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。 6 7## 12000001 该子功能不支持（特性） 8 9**错误信息** 10 11The ``${messageInfo}`` is not supported. 12 13**可能原因** 14 15支持API，但是不支持API内部某些子特性（功能），如算法参数。 16 17**处理步骤** 18 19调整API参数，使用可替代可支持的参数。 20 21## 12000002 缺少密钥算法参数 22**错误信息** 23 24Failed to obtain the ``${messageInfo}``. It is not set in ParamSet. 25 26**可能原因** 27 28使用密钥时缺少相关参数。 29 30**处理步骤** 31 321. 查看errorMessage确认缺少的密钥参数。 332. 添加对应的正确的密钥参数。 34 35## 12000003 无效的密钥算法参数 36 37**错误信息** 38 39Invalid ``${messageInfo}``. 40 41**可能原因** 42 43使用密钥时无效相关参数。 44 45**处理步骤** 46 471. 查看errorMessage确认无效的的密钥参数名。 482. 修改对应的密钥参数。 49 50## 12000004 文件错误 51 52**错误信息** 53 54可能为以下的其中一种： 55 56- Insufficient storage space. 57- Invalid file size. 58- Failed to ``${messageInfo}``. 59 60 61**可能原因** 62 63文件操作错误。 64 65**处理步骤** 66 671. 查看是否磁盘空间已经写满、文件系统是否有其他异常。 682. 清理磁盘。 69 70## 12000005 进程通信错误 71 72**错误信息** 73 74可能为以下的其中一种： 75 76- Failed to get messages from IPC. 77- IPC ``${messageInfo}``. 78 79**可能原因** 80 81进程通信错误。 82 83**处理步骤** 84 85查看错误信息，排查是否进程IPC通信问题。 86 87## 12000006 算法库操作失败 88 89**错误信息** 90 91Crypto engine error. 92 93**可能原因** 94 95该错误码表示算法库操作失败，可能原因如下。 96 971. 算法库加解密错误，可能是密文数据不对。 982. 密钥参数不正确。 99 100**处理步骤** 101 1021. 排查密文数据是否正确。 1032. 排查加解密参数是否正确。 104 105## 12000007 密钥访问失败 - 密钥已失效 106 107**错误信息** 108 109This credential is invalidated permanently. 110 111**可能原因** 112 113该错误码表示密钥访问失败 - 密钥已失效，可能原因如下。 114 1151. 该密钥设置了清除密码失效的用户认证访问控制属性，清除过设备密钥导致密钥失效。 1162. 该密钥设置了新录入生物特征失效的用户认证访问控制属性，由于录入过新的指纹或人脸导致该密钥失败。 117 118**处理步骤** 119 1201. 确认日志是哪种方式导致的认证不通过。 1212. 如果使用了正确参数，但是失效控制导致认证不通过，则该密钥已经无法使用。 122 123## 12000008 密钥访问失败 - 密钥认证失败 124 125**错误信息** 126 127The authentication token verification failed. 128 129**可能原因** 130 131该密钥设置了用户认证访问控制属性，由于challenge参数不正确导致无法通过认证。 132 133**处理步骤** 134 1351. 检查userIAM认证的challenge参数组装是否正确。 1362. 如果是challenge参数不正确导致，则修改正确的组装方式，使用huks生成challenge组装，并传入userIAM重新认证。 137 138## 12000009 密钥访问失败 - 密钥访问超时 139 140**错误信息** 141 142This authentication token timed out. 143 144**可能原因** 145 146该密钥设置了用户认证访问控制属性，由于使用时间窗timeout导致无法通过认证。 147 148**处理步骤** 149 150如果是timeout导致不正确，则重新触发密钥init并重新认证，使得认证时间和密钥init时间小于设置的timeout时间。 151 152## 12000010 密钥操作会话数已达上限 153 154**错误信息** 155 156The number of key operation sessions has reached the limit. 157 158**可能原因** 159 160同时使用huks进行密钥会话操作的调用方（同应用或者跨应用）过多，已经达到上限（15个）。 161 162**处理步骤** 163 1641. 检查同应用内部是否同时存在多个密钥会话操作（init)，存在则修改避免同时调用。 1652. 如不存在上述情形，则可能是其它应用同时调用多个会话，通过等待其它应用释放会话后再使用。 166 167## 12000011 目标对象不存在 168 169**错误信息** 170 171The entity does not exist. 172 173**可能原因** 174 175该别名对应的密钥不存在。 176 177**处理步骤** 178 1791. 检查密钥别名是否拼写错误。 1802. 检查改密钥别名对应的密钥是否生成成功。 181 182## 12000012 外部错误 183 184**错误信息** 185 186System external error. 187 188**可能原因** 189 190外部的硬件出错，文件错误等。 191 192**处理步骤** 193 194拿错误码与日志在社区反馈。 195 196## 12000013 密钥设置生物访问控制时，待绑定的凭据不存在 197 198**错误信息** 199 200The credential does not exist. 201 202**可能原因** 203 204密钥绑定PIN、指纹、人脸时，未录入相关凭据。 205 206**处理步骤** 207 208录入相关凭据，或更改绑定凭据类型。 209 210## 12000014 内存不足 211 212**错误信息** 213 214可能为以下的其中一种： 215 216- Insufficient memory. 217- Malloc failed. 218 219**可能原因** 220 221系统内存不足，或出参缓存太小。 222 223**处理步骤** 224 2251. 开发者释放部分内存或重启。 2262. 检查传入的出参缓存大小。 227 228## 12000015 调用其他系统服务失败 229 230**错误信息** 231 232Failed to obtain the ``${messageInfo}`` information via UserIAM. 233 234**可能原因** 235 236其他系统服务未启动。 237 238**处理步骤** 239 240开发者等待一段时间后尝试再次触发调用。 241 242## 12000016 需要锁屏密码但未设置 243 244**错误信息** 245 246A device password is required but not set. 247 248**可能原因** 249 250业务限制了密钥只有在设置了锁屏密码时才可用，但未设置锁屏密码。 251 252**处理步骤** 253 254设置锁屏密码，或更换密钥的使用限制。 255