使用Node.js SDK时如果请求出错,会有相应的异常抛出,同时在log(默认为程序运行目录下oss_sdk.log)中也会记录详细的出错信息。

ClientError

ClientError指SDK内部出现的异常,例如参数设置错误、断点续传上传或断点续传下载过程中出现的文件被修改的错误。

RequestError

当网络出现中断或者异常时,Node.js SDK会抛出RequestError。出现此错误时,请检查网络连通性并确保网络正常后再重试。

ServerError

ServerError指服务器端错误,它来自于对服务器错误信息的解析。ServerError有以下几个属性:
  • status:出错请求的HTTP状态码。
  • code:OSS的错误码。
  • message:OSS的错误信息。
  • requestId:标识该次请求的UUID。当您无法解决问题时,可以凭requestId来寻求OSS开发工程师的帮助。

OSS中常见的错误信息请参见OSS错误响应

调试

当您使用Node.js遇到客户端或者服务端错误时,您可以通过设置DEBUG环境变量来开启调试。

DEBUG=ali-oss node app.js

在浏览器环境中,您可以通过在console中设置localStorage.debug变量来开启调试。

localStorage.debug = 'ali-oss'