使用SDK時如果請求出錯,會有相應的異常拋出,同時在log(預設為程式運行目錄下oss_sdk.log)中也會記錄詳細的出錯資訊。
OSS Ruby SDK中有兩種異常:ClientError和ServerError,它們都是RuntimeError的子類。
ClientError
ClientError指SDK內部出現的異常,比如參數設定錯誤或者斷點上傳/下載中出現的檔案被修改的錯誤。
ServerError
ServerError指伺服器端錯誤,它來自於對伺服器錯誤資訊的解析。ServerError有以下幾個屬性:
- http_code: 出錯請求的HTTP狀態碼
- error_code: OSS的錯誤碼
- message: OSS的錯誤資訊
- request_id: 標識該次請求的UUID;當您無法解決問題時,可以憑這個RequestId來請求OSS開發工程師的幫助
OSS中常見的錯誤資訊請參考 OSS錯誤響應