使用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'