目录

ArkTS API错误码

  • 以下仅介绍本模块特有错误码,通用错误码请参考通用错误码。
  • Remote Communication Kit错误码映射关系:1007900000 + curl错误码。Remote Communication Kit常见错误码如下, 更多错误码可参考:curl错误码。

1007900001 不支持的协议

错误信息

Unsupported protocol.

错误描述

协议版本服务器不支持。

可能原因

传入的协议版本,服务器不支持。

处理步骤

请检查传入的协议版本是否合理,排查服务器实现。

1007900003 URL格式错误

错误信息

URL using bad/illegal format or missing URL.

错误描述

URL格式错误。

可能原因

可能传入的url格式不正确。

处理步骤

检查传入的url格式是否正确。

1007900005 代理服务器域名解析失败

错误信息

Couldn't resolve proxy name.

错误描述

代理服务器的域名无法解析。

可能原因

服务器的URL不正确。

处理步骤

排查代理服务器的URL是否正确。

1007900006 域名解析失败

错误信息

Couldn't resolve host name.

错误描述

服务器的域名无法解析。

可能原因

  1. 传入的服务器的URL不正确。
  2. 网络不通畅。

处理步骤

  1. 请检查输入的服务器的URL是否合理。
  2. 请检查网络连接情况。

1007900007 无法连接到服务器

错误信息

Couldn't connect to server.

错误描述

服务器无法连接。

可能原因

网络断开。

处理步骤

检查网络连接。

1007900008 服务器返回非法数据

错误信息

Weird server reply.

错误描述

服务器返回非法数据。

可能原因

服务器出错,返回了非HTTP格式的数据。

处理步骤

排查服务器实现。

1007900009 拒绝对远程资源的访问

错误信息

Access denied to remote resource.

错误描述

拒绝对远程资源的访问。

可能原因

指定的内容被服务器拒绝访问。

处理步骤

排查请求内容。

1007900016 HTTP2帧层错误

错误信息

Error in the HTTP2 framing layer.

错误描述

HTTP2层级的错误。

可能原因

服务器不支持HTTP2。

处理步骤

抓包分析、排查服务器是否支持HTTP2。

1007900018 服务器返回数据不完整

错误信息

Transferred a partial file.

错误描述

服务器返回的数据不完整。

可能原因

可能与服务器实现有关。

处理步骤

排查服务器实现。

1007900025 上传失败

错误信息

Upload failed.

错误描述

上传失败。

可能原因

文件过大或者网络问题。对于FTP,服务器通常会拒绝STOR命令。错误缓冲区通常包含服务器的解释。

处理步骤

排查文件大小及网络状况。

1007900026 从文件/应用程序中打开/读取本地数据失败

错误信息

Failed to open/read local data from file/application.

错误描述

从文件/应用程序中打开/读取本地数据失败。

可能原因

应用没有读文件权限。

处理步骤

排查应用权限。

1007900027 内存不足

错误信息

Out of memory.

错误描述

内存不足。

可能原因

内存不足。

处理步骤

排查系统内存。

1007900028 操作超时

错误信息

Timeout was reached.

错误描述

操作超时。

可能原因

TCP连接超时或读写超时。

处理步骤

排查网络问题。如果连续多次遇到1007900028错误码,建议把Session关闭后,重新创建Session。

1007900047 重定向次数达到最大值

错误信息

Number of redirects hit maximum amount.

错误描述

重定向次数达到最大值。

可能原因

重定向次数过多。

处理步骤

排查服务器实现。

1007900052 服务器没有返回内容

错误信息

Server returned nothing (no headers, no data).

错误描述

服务器没有返回内容。

可能原因

与服务器实现有关。

处理步骤

排查服务器实现。

1007900055 发送网络数据失败

错误信息

Failed sending data to the peer.

错误描述

无法向对端发送数据,发送网络数据失败。

可能原因

网络问题。

处理步骤

排查网络。

1007900056 接收网络数据失败

错误信息

Failure when receiving data from the peer.

错误描述

无法从对端收到数据,接收网络数据失败。

可能原因

网络问题。

处理步骤

排查网络问题。

1007900058 本地SSL证书错误

错误信息

Problem with the local SSL certificate.

错误描述

本地SSL证书错误。

可能原因

SSL证书格式有错误。

处理步骤

检查SSL证书格式。

1007900059 无法使用指定的密码

错误信息

Couldn't use specified SSL cipher.

错误描述

无法使用指定的密码。

可能原因

client和sever协商的加密算法系统不支持。

处理步骤

抓包分析协商的算法。

1007900060 远程服务器SSL证书或SSH秘钥不正确

错误信息

SSL peer certificate or SSH remote key was not OK.

错误描述

远程服务器SSL证书或SSH秘钥错误或者无效。

可能原因

无法校验服务器身份,有可能是证书过期了。

处理步骤

检查证书有效性。

1007900061 无法识别或错误的HTTP编码格式

错误信息

Unrecognized or bad HTTP Content or Transfer-Encoding.

错误描述

无法识别或错误的HTTP编码格式。

可能原因

HTTP编码格式不正确。

处理步骤

排查服务器实现,目前仅支持gzip编码。

1007900063 超出最大文件大小

错误信息

Maximum file size exceeded.

错误描述

超出最大文件大小。

可能原因

下载的文件超过50M。

处理步骤

排查服务器实现。

1007900070 服务器磁盘空间不足

错误信息

Disk full or allocation exceeded.

错误描述

服务器磁盘空间不足。

可能原因

服务器磁盘已满。

处理步骤

检查服务器磁盘空间。

1007900073 服务器返回文件已存在

错误信息

Remote file already exists.

错误描述

服务器返回文件已存在。

可能原因

上传文件的时候,服务器返回文件已经存在。

处理步骤

排查服务器。

1007900077 SSL CA证书不存在或没有访问权限

错误信息

Problem with the SSL CA cert (path? access rights?).

错误描述

SSL CA证书不存在或没有访问权限。

可能原因

证书不存在或者没有访问权限。

处理步骤

检查证书是否存在或者有没有访问权限。

1007900078 URL请求的文件不存在

错误信息

Remote file not found.

错误描述

URL请求的文件不存在。

可能原因

URL请求的文件不存在。

处理步骤

检查URL请求的文件是否存在。

1007900094 身份校验失败

错误信息

An authentication function returned an error.

错误描述

身份校验失败。

可能原因

传入的校验身份的字段与服务器不匹配。

处理步骤

排查传入的校验身份的字段是否与服务器匹配。

1007900999 内部错误

错误信息

Internal Error.

错误描述

内部错误。

可能原因

通常意味着在系统中发生了一些未知的错误,导致无法完成请求。

处理步骤

如果遇到此错误,请尝试重新启动应用程序或联系技术支持以获取帮助。

1007900998 所请求的方法不被支持

错误信息

Method not supported.

错误描述

方法不被支持。

可能原因

使用一个不被支持的API 方法或协议。

处理步骤

检查代码或应用程序,确保使用的方法和协议是正确的。

1007900997 无效的内容类型

错误信息

Invalid content type.

错误描述

内容类型无效。

可能原因

使用不受支持的数据格式或内容类型进行请求。

处理步骤

确保请求的是正确的内容类型,并使用支持的数据格式进行请求。

1007900996 代理类型不支持

错误信息

Proxy type not supported.

错误描述

代理类型不支持。

可能原因

使用不受支持的代理类型。

处理步骤

换一种代理类型或者禁用代理,然后重新连接。

1007900995 获取系统代理失败

错误信息

Get system proxy failed.

错误描述

获取到的系统代理失败。

可能原因

没有正确配置代理设置或代理设置不正确导致的。

处理步骤

检查网络设置,确保代理设置正确。

1007900993 会话已关闭

错误信息

Session is closed.

错误描述

会话已关闭。

可能原因

应用程序在尝试使用已经关闭的会话或会话已过期的情况下执行某些操作。

处理步骤

在应用程序中重新打开会话或创建新的会话,以便继续执行所需的操作。

1007900992 请求已被取消

错误信息

Request is canceled.

错误描述

该请求已被取消。

可能原因

由于请求超时,网络连接中断等原因导致的。

处理步骤

尝试重新发起请求,并确保网络连接稳定。

1007900991 服务器返回的响应内容不符合预期的格式或规范

错误信息

The response is invalid.

错误描述

服务器返回的响应内容不符合预期的格式或规范,导致客户端无法正确解析或处理该响应

可能原因

客户端请求的参数或格式不符合服务器的预期,导致服务器返回错误的响应。

处理步骤

验证客户端发送的请求是否正确,确保所有必要的参数都已正确设置,并且请求的格式符合服务器的要求。

1007900994 会话数达到限制

错误信息

Sessions number reached limit.

错误描述

会话数达到限制。

可能原因

session创建数量过多导致,当前最多可创建16个session实例。

处理步骤

减少创建的session数量,不超过16个。

201 权限被拒绝

错误信息

Permission denied.

错误描述

应用权限不足或格式错误。

可能原因

应用的权限配置不正确。

处理步骤

检查用户的权限配置是否正确。

401 参数错误

错误信息

Parameter error.

错误描述

函数入参非法。

可能原因

传入的参数非法。

处理步骤

请检查传入的参数是否合理,排查服务实现。

1007910001 请求数据传输错误

错误信息

Urpc some error.

错误描述

URPC数据传输过程发生错误。

可能原因

参见URPC的日志。

处理步骤

排查URPC日志确认具体错误原因。

1007910002 请求超时

错误信息

Timeout was reached.

错误描述

URPC请求超出开发者配置的UrpcConnectConfiguration时长。

可能原因

  1. 请求侧请求发送失败,底层发送队列阻塞。
  2. 服务侧发生异常,未正常回复response。

处理步骤

  1. 原因1重试请求发送。
  2. 原因2重启服务端。

1007910003 请求被取消

错误信息

Request is cancel.

错误描述

URPC请求被取消。

可能原因

某次发送的URPC请求被开发者调用的资源清理接口,导致取消。

处理步骤

排查业务流程是否存在请求未发送完毕就清理资源。

1007910004 连接断开

错误信息

Urpc disconnect.

错误描述

URPC连接断开。

可能原因

网络原因导致网络断开。

处理步骤

排查网络情况。

1007910005 请求数量达到上限

错误信息

Limit of request number.

错误描述

URPC请求数目达到服务端请求处理上限。

可能原因

开发者发送大量请求且未对其相应进行处理。

处理步骤

排查请求侧实现。

1007910006 请求大小达到上限

错误信息

Limit of request size.

错误描述

URPC请求大小达到系统内存上限。

可能原因

开发者发送的请求大小超出上限。

处理步骤

排查请求侧实现。

1007910008 恢复发送失败

错误信息

Resume transmit error.

错误描述

断点续传的请求,恢复发送失败。

可能原因

触发断点续传时,发送链路异常。

处理步骤

排查请求侧日志。

1007910099 取消时Stub查询失败

错误信息

Urpc stub not found.

错误描述

在调用cancel方法时,未查询到Stub。

可能原因

Stub提前触发销毁了。

处理步骤

排查UrpcStub类的声明和使用是否正确。

10079100997 数据反序列化失败

错误信息

Deserialize failed.

错误描述

数据反序列化失败。

可能原因

数据内容错误,与预期的序列化后的数据不符。

处理步骤

根据日志,排查服务侧数据发送状况。

10079100998 远程调用方法错误

错误信息

Function name error.

错误描述

请求侧的方法名指定错误。

可能原因

请求侧的方法名指定错误。

处理步骤

排查请求侧方法名。

10079100999 URPC Stub查询失败

错误信息

Urpc stub not found.

错误描述

未正确使用Urpcstub。

可能原因

stub使用错误。

处理步骤

排查UrpcStub类的声明和使用是否正确。