17620001 内存操作失败
错误信息
Memory operation failed.
错误描述
内存操作失败。
可能原因
当前系统内存分配失败。
处理步骤
- 检查当前系统功能是否正常。
- 业务检查数据是否超长,导致系统无法分配内存。
17620002 获取Native对象失败或参数转换失败
错误信息
Failed to obtain the native object or convert parameters.
错误描述
获取Native对象失败或参数转换失败。
可能原因
- 调用接口的实例对象不是由本模块对应的接口创建,导致获取Native对象失败。
- 系统内部出现空指针。
- 系统出现的不可预期的错误。
处理步骤
- 检查调用接口的实例对象是否由本模块对应的接口正确创建。
- 系统异常,请稍后重试或重启设备。
- 若以上检查均无法定位问题,请收集日志信息并联系华为技术支持。
17620003 参数检查失败
错误信息
Parameter check failed.
错误描述
参数检查失败。
可能原因
输入的参数超出了规格范围,如长度、值等。
处理步骤
检查当前输入的参数是否在支持的范围内。
17620004 无效的函数调用
错误信息
Invalid function call.
错误描述
无效的函数调用。
可能原因
当前操作不支持当前函数调用。
处理步骤
检查当前函数调用是否合理。
17630001 密码操作错误
错误信息
Crypto operation error.
错误描述
密码操作错误。
可能原因
加解密算法框架与三方算法库交互时,出现错误。
处理步骤
检查该接口或相关联接口输入参数的正确性。
开发者在解密时经常遇到报错17630001,下文按照典型场景分类详细分析。
[h2]使用AES-GCM算法解密时调用doFinal失败
问题现象
AES-GCM解密时调用doFinal失败,返回错误码17630001。
- 建议开发者使用update接口加密数据,最后调用doFinal接口完成本次加密,获取tag。
- 建议开发者使用update接口解密数据,最后调用doFinal接口完成本次解密,doFinal接口内将会对tag进行验证,若失败,接口会抛出异常。
可能原因
doFinal失败,表示校验tag失败,解密输入的tag和解密过程中计算的tag不一致。解密输入的key、iv、aad、tag和ciphertext,任意一个不正确,都会导致该报错。
- key不正确,update得到的明文不正确,doFinal失败,即校验tag失败。
- iv不正确,update得到的明文不正确,doFinal失败,即校验tag失败。
- aad不正确,update得到的明文正确,doFinal失败,即校验tag失败。
- ciphertext不正确,update得到的明文不正确,doFinal失败,即校验tag失败。
- tag不正确,update得到的明文正确,doFinal失败,即校验tag失败。
解决措施
确认加密和解密的key、iv和aad参数一致,确保解密时输入的ciphertext和tag是正确的。
[h2]使用AES-CBC算法解密时调用doFinal失败
问题现象
解密时调用doFinal失败,返回错误码17630001。
AES-CBC属于块加密算法,因此需要使用到填充算法PKCS #7,将明文填充至块大小整数倍。
解密时,doFinal接口会对padding进行校验。
可能原因
doFinal失败,表示校验padding失败,doFinal对最后一块密文数据解密,并校验padding是否合法。解密输入的key、iv和ciphertext,任意一个不正确,都可能会导致该报错。
- key不正确,update得到的明文不正确,doFinal失败,即校验padding失败。
- iv不正确,完整的密文长度为16字节,update无输出,doFinal失败,即校验padding失败;完整的密文长度是16字节的整数倍(不包含16字节),update得到的明文部分正确,doFinal成功。
- ciphertext不正确,倒数第一个或第二个密文块错误,update得到的明文部分正确(或无输出),doFinal失败,即校验padding失败;其他密文块错误,update得到的明文部分正确,doFinal成功。
解决措施
确认加密和解密的key和iv参数一致,确保解密时输入的ciphertext是正确的。
[h2]使用AES-CCM算法解密时调用doFinal失败
问题现象
AES-CCM解密时调用doFinal失败,返回错误码17630001。
- AES-CCM为认证加密模式,加解密时需要指定附加验证数据aad(长度需大于等于1字节且小于等于2048字节)和认证标签tag。
- 建议开发者使用update接口加密数据,最后调用doFinal接口完成本次加密,获取tag。
- 建议开发者使用update接口解密数据,最后调用doFinal接口完成本次解密,doFinal接口内将会对tag进行验证,若失败,接口会抛出异常。
可能原因
doFinal失败,表示校验tag失败,解密输入的tag和解密过程中计算的tag不一致。解密输入的key、iv、aad、tag和ciphertext,任意一个不正确,都会导致该报错。
- key不正确,update得到的明文不正确,doFinal失败,即校验tag失败。
- iv不正确,update得到的明文不正确,doFinal失败,即校验tag失败。
- aad不正确,update得到的明文正确,doFinal失败,即校验tag失败。
- ciphertext不正确,update得到的明文不正确,doFinal失败,即校验tag失败。
- tag不正确,update得到的明文正确,doFinal失败,即校验tag失败。
解决措施
确认加密和解密的key、iv和aad参数一致,确保解密时输入的ciphertext和tag是正确的。
[h2]使用AES-ECB算法解密时调用doFinal失败
问题现象
AES-ECB解密时调用doFinal失败,返回错误码17630001。
AES-ECB属于块加密算法,分组长度为128位(16字节),因此需要使用到填充算法PKCS #7,将明文填充至分组大小的整数倍。
解密时,doFinal接口会对padding进行校验。
可能原因
doFinal失败,表示校验padding失败,doFinal对最后一块密文数据解密,并校验padding是否合法。解密输入的key和ciphertext,任意一个不正确,都可能会导致该报错。
- key不正确,update得到的明文不正确,doFinal失败,即校验padding失败。
- ciphertext不正确,最后一个密文块错误,update得到的明文部分正确,doFinal失败,即校验padding失败;其他密文块错误,update得到的明文部分正确,doFinal成功。
- ciphertext长度不是16字节(分组大小)的整数倍(使用PKCS #7填充时),doFinal失败。
解决措施
确认加密和解密的key参数一致,确保解密时输入的ciphertext是正确的,且密文长度为分组大小(16字节)的整数倍。
[h2]使用DES/3DES算法解密时调用doFinal失败
问题现象
DES或3DES解密时调用doFinal失败,返回错误码17630001。
DES/3DES为分组加密算法,分组长度为64位(8字节)。ECB、CBC模式下,明文长度不是64位整数倍时,必须使用填充方法补足。
解密时,doFinal接口会对padding进行校验。
若使用NoPadding模式,key、iv或密文不正确(长度均符合要求)时,解密仍能成功,但得到的明文是错误的。
可能原因
doFinal失败,表示校验padding失败。解密输入的key内容错误(长度正确但密钥值不正确)或ciphertext不正确,都可能会导致该报错。
- key内容不正确(DES密钥应为8字节,3DES密钥应为24字节),update得到的明文不正确,doFinal失败。
- iv不正确(CBC/OFB/CFB模式下iv为8字节):CBC和CFB模式下仅影响第一个密文块的解密,update得到的明文部分不正确,doFinal成功;OFB为流密码,iv不正确将导致所有明文不正确,但doFinal仍成功。
- ciphertext不正确,ECB模式下最后一个密文块错误,或CBC模式下倒数第一或第二个密文块错误时,doFinal失败,即padding校验失败;其他密文块错误,doFinal成功,但得到的明文不正确。
- ciphertext长度不是8字节(分组大小)的整数倍(使用PKCS #7填充时),doFinal失败。
解决措施
确认加密和解密的key和iv参数一致,确保解密时输入的ciphertext是正确的。DES密钥长度为8字节,3DES密钥长度为24字节。
[h2]使用SM4-GCM算法解密时调用doFinal失败
问题现象
SM4-GCM解密时调用doFinal失败,返回错误码17630001。
- SM4-GCM为认证加密模式,加解密时需要指定附加验证数据aad和认证标签tag。
- 建议开发者使用update接口加密数据,最后调用doFinal接口完成本次加密,获取tag。
- 建议开发者使用update接口解密数据,最后调用doFinal接口完成本次解密,doFinal接口内将会对tag进行验证,若失败,接口会抛出异常。
可能原因
doFinal失败,表示校验tag失败,解密输入的tag和解密过程中计算的tag不一致。解密输入的key、iv、aad、tag和ciphertext,任意一个不正确,都会导致该报错。
- key不正确,update得到的明文不正确,doFinal失败,即校验tag失败。
- iv不正确,update得到的明文不正确,doFinal失败,即校验tag失败。
- aad不正确,update得到的明文正确,doFinal失败,即校验tag失败。
- ciphertext不正确,update得到的明文不正确,doFinal失败,即校验tag失败。
- tag不正确,update得到的明文正确,doFinal失败,即校验tag失败。
解决措施
确认加密和解密的key、iv和aad参数一致,确保解密时输入的ciphertext和tag是正确的。
[h2]使用SM4-ECB/CBC算法解密时调用doFinal失败
问题现象
SM4-ECB或SM4-CBC解密时调用doFinal失败,返回错误码17630001。
SM4为分组加密算法,分组长度为128位。ECB、CBC模式下,明文长度不是128位整数倍时,必须使用填充方法补足。
解密时,doFinal接口会对padding进行校验。
可能原因
doFinal失败,表示校验padding失败。解密输入的key和ciphertext,任意一个不正确,都可能会导致该报错。
- key不正确(SM4密钥应为16字节),update得到的明文不正确,doFinal失败,即校验padding失败。
- iv不正确(CBC模式下iv为16字节),仅影响第一个密文块的解密,update得到的明文部分不正确,doFinal成功。
- ciphertext不正确,ECB模式下最后一个密文块错误,或CBC模式下倒数第一或第二个密文块错误时,doFinal失败,即padding校验失败;其他密文块错误,doFinal成功,但得到的明文不正确。
- ciphertext长度不是16字节(分组大小)的整数倍(使用PKCS #7填充时),doFinal失败。
解决措施
确认加密和解密的key和iv参数一致,确保解密时输入的ciphertext是正确的。SM4密钥长度为16字节(128位)。
[h2]使用ChaCha20-Poly1305算法解密时调用doFinal失败
问题现象
ChaCha20-Poly1305解密时调用doFinal失败,返回错误码17630001。
- ChaCha20-Poly1305为认证加密模式,加解密时需要指定附加验证数据aad和认证标签tag。
- 建议开发者使用update接口加密数据,最后调用doFinal接口完成本次加密,获取tag。
- 建议开发者使用update接口解密数据,最后调用doFinal接口完成本次解密,doFinal接口内将会对tag进行验证,若失败,接口会抛出异常。
可能原因
doFinal失败,表示校验tag失败,解密输入的tag和解密过程中计算的tag不一致。解密输入的key、nonce(IV)、aad、tag和ciphertext,任意一个不正确,都会导致该报错。
- key值不正确(key长度正确,但key内容不正确),update得到的明文不正确,doFinal失败,即校验tag失败。
- nonce不正确(nonce为12字节),update得到的明文不正确,doFinal失败,即校验tag失败。
- aad不正确,update得到的明文正确,doFinal失败,即校验tag失败。
- ciphertext不正确,update得到的明文不正确,doFinal失败,即校验tag失败。
- tag不正确,update得到的明文正确,doFinal失败,即校验tag失败。
解决措施
确认加密和解密的key、nonce和aad参数一致,确保解密时输入的ciphertext和tag是正确的。