全部產品
Search
文件中心

Object Storage Service:異常處理(Ruby SDK)

更新時間:Nov 29, 2025

使用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。您可以憑藉此Request ID聯絡支援人員,排查並解決您遇到的問題。

更多資訊,請參見OSS錯誤碼。