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