Object Storage Service：Go錯誤處理

用戶端錯誤

Go SDK中調用出錯會統一返回error介面，該介面定義如下：

type error interface {
    Error() string
}

其它錯誤繼承該介面。比如HTTP錯誤請求返回的錯誤如下：

//net.Error 
type Error interface {
    error
    Timeout() bool   // Is the error a timeout
    Temporary() bool // Is the error temporary
}

伺服器端錯誤

使用OSS Go SDK時如果請求出錯，會返回相應的error。HTTP請求、IO等錯誤會返回Go語言自訂錯誤。OSS Server處理請求出錯，則返回如下的錯誤，該錯誤實現了Error介面。

type ServiceError struct {
    Code       string    // OSS返回給使用者的錯誤碼
    Message    string    // OSS給出的詳細錯誤資訊
    RequestId  string    // 用於唯一標識該次請求的UUID
    HostId     string    // 用於標識訪問的OSS叢集
    StatusCode int       // HTTP狀態代碼
}

如果OSS返回的HTTP狀態代碼與預期不符，則返回如下錯誤，該錯誤也實現了Error介面。

type UnexpectedStatusCodeError struct {
    allowed []int    // 預期OSS返回HTTP狀態代碼
    got     int      // OSS實際返回HTTP狀態代碼
}

錯誤處理樣本

以下代碼用於展示錯誤處理：

package main
import (
    "fmt"
    "os"
    "strings"
    "github.com/aliyun/aliyun-oss-go-sdk/oss"
)
// 錯誤處理函數。
func HandleError(err error) {
    fmt.Println("Error:", err)
    os.Exit(-1)
}
func main() {
    /// 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
    provider, err := oss.NewEnvironmentVariableCredentialsProvider()
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }

    // 建立OSSClient執行個體。
    // yourEndpoint填寫Bucket對應的Endpoint，以華東1（杭州）為例，填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
    client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
    if err != nil {
        HandleError(err)
    }
    // 填寫儲存空間名稱，例如examplebucket。
    bucketName := "examplebucket"
    // 填寫Object名稱，例如exampleobject.txt。
    objectName := "exampleobject.txt"
    
    bucket, err := client.Bucket(bucketName)
    if err != nil {
        HandleError(err)
    }
    // 上傳字串。
    err = bucket.PutObject(objectName, strings.NewReader("Hello OSS"))
    if err != nil {
        HandleError(err)
   }
}

OSS錯誤碼

OSS錯誤碼列表如下：