Alibaba Cloud SDK：常見問題

問題1：AK傳參問題。

問題現象：代碼運行時報錯，報錯資訊中包含如下資訊時，表示AK未正確地設定阿里雲的憑證（AccessKey）。

• V2.0 SDK：InvalidCredentials: Please set up the credentials correctly. If you are setting them through environment variables, please ensure that ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET are set correctly.

• V1.0 SDK：SDK.ServerError InvalidAccessKeyId.NotFound Specified access key is not found.

解決方案：

1. 執行以下命令，檢查您的環境變數中是否配置有ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET：

   Linux/macOS

   echo $ALIBABA_CLOUD_ACCESS_KEY_ID
   echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET

   Windows

   echo %ALIBABA_CLOUD_ACCESS_KEY_ID%
   echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%

   若返回正確的AccessKey，則說明配置成功。如果返回為空白或錯誤，請嘗試重新設定，具體操作請參見在Linux、macOS和Windows系統配置環境變數。

2. 檢查代碼中AK相關內容是否存在錯誤。

   常見的錯誤樣本：

     config := &openapi.Config{
       AccessKeyId: tea.String(os.Getenv("yourAccessKeyID")),
       AccessKeySecret: tea.String(os.Getenv("yourAccessKeySecret")),
     }

   正確樣本：

    config := &openapi.Config{
       AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
       AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
     }

   說明

   os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")和os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")，表示是從環境變數中擷取ALIBABA_CLOUD_ACCESS_KEY_ID及ALIBABA_CLOUD_ACCESS_KEY_SECRET的值。

   重要

   切勿直接線上上代碼中明文寫入 AccessKey，該寫法存在安全隱患。

問題2：SDK無法串連到阿里雲服務，錯誤碼是什嗎？

常見的錯誤碼包括：

• InvalidAccessKeyId：檢查您的Access Key ID是否填寫正確。

• SignatureDoesNotMatch：檢查您的Access Key Secret是否填寫正確。

確保網路通暢，且沒有被防火牆阻擋。

問題3：調用API逾時，提示：”*net.DNSError ”或 “*net.OpError “？

逾時問題可能由多種因素引起，以下是一些常見的原因及相應的解決步驟：

網路連接問題

情況描述：用戶端與伺服器之間的網路不通或網路不穩定導致請求無法到達目標伺服器。

解決方案：

使用ping或curl命令測試本地主機與雲產品Endpoint之間連通性，例如調用傳送簡訊介面逾時時，使用ping dysmsapi.aliyuncs.com或curl -v https://dysmsapi.aliyuncs.com測試連通性。

• 若命令執行逾時或者無響應，請檢查本地防火牆或路由器中是否有阻斷策略。

• 若命令有響應，建議設定合理的逾時時間，避免因配置不當導致請求失敗，具體操作請參見逾時機制。範例程式碼如下：

          // 建立RuntimeObject執行個體並設定運行參數。
  	runtime := &util.RuntimeOptions{}
  	// 逾時參數設定，單位 ms（毫秒）
  	runtime.ConnectTimeout = tea.Int(10000) // 設定連線逾時為10秒

API處理時間過長

情況描述：目標API處理請求的時間超過了設定的讀逾時時間。

解決方案：通過配置或增加逾時時間來適應較長的API回應時間， 具體操作請參見逾時機制。例如通過配置讀逾時時間參數來延長當前請求的讀逾時時間，範例程式碼如下：

        // 建立RuntimeObject執行個體並設定運行參數。
	runtime := &util.RuntimeOptions{}
	// 逾時參數設定，單位 ms（毫秒）
	runtime.ReadTimeout = tea.Int(10000) // 設定讀逾時為10秒

問題4：不同庫之間的依賴版本衝突導致編譯失敗或遇到missing go.sum entry？

出現missing go.sum entry錯誤是由於使用了某個依賴，但go.sum檔案缺少相關條目所致。GO語言使用go.mod來管理依賴，確保go.mod檔案中沒有衝突的版本依賴。在Terminal中執行以下命令，以整理和更新當前模組的依賴關係。並更新go.mod和go.sum檔案。

go mod tidy

問題5：如何在已有專案中使用Go SDK?

1. 開啟VS Code，在VS Code功能表列，單擊File->Open Folder，建立一個專案檔夾或者選擇一個已有的專案檔夾。例如檔案夾名稱為gosdkproject，然後選擇該檔案夾。

2. 在VS Code功能表列中單擊Terminal->New Terminal，將會在底部展示Terminal視窗。並在Terminal中執行go mod init gosdkprojects進行Go專案初始化。初始化完成之後會在當前專案目錄下產生一個go.mod的檔案，go.mod是Go語言專案中的模組檔案，用於管理專案的依賴關係和版本資訊。

3. 訪問SDK中心，選擇您想要使用的 SDK的雲產品。SDK版本選擇V2.0，語言選擇Go。複製安裝命令到Terminal中，然後按下斷行符號執行。

問題6: 調用API時發生”MissingRequiredParameter“類型錯誤？

這裡以調用簡訊服務的傳送簡訊介面為例：

• 進入OpenAPI門戶的API調試頁面，選擇雲產品和介面。

• 仔細對比構造的請求對象（如 SendSmsRequest）是否填充了所有必需欄位，例如手機號、簽名等。

• 參考API文檔確認必填項。確保必填參數值正確。

• 確保填寫的必填參數值正確無誤，例如手機號格式是否符合要求。

• 在調用 API 前，SDK 會對參數進行自動校正。如果缺少必要參數，您將收到類似 MissingRequiredParameter 的錯誤提示。例如，如果手機號參數缺失，會報錯 “MissingPhoneNumbers: code: 400”。

                 sendSmsRequest := &dysmsapi20170525.SendSmsRequest{
		 // 需替換成為您的簡訊模板code
		 TemplateCode: tea.String("<YOUR_VALUE>"),
		 // 樣本值：{\"code\":\"1234\"}
		 TemplateParam: tea.String("{\"code\":\"1234\"}"),
		 // 需替換成為您的接收手機號碼
	         PhoneNumbers: tea.String("<YOUR_VALUE>"),
	         // 需替換成為您的簡訊簽名
	         SignName: tea.String("<YOUR_VALUE>"),
	}

問題7：API 呼叫失敗，提示地區不支援，提示”404 Not Found“？

確保您所選地區支援您正在調用的服務。這裡以簡訊服務為例，查看產品的Endpoint可以通過OpenAPI 開發人員門戶的產品首頁中進行尋找確認，請確保填寫正確的Endpoint。

問題8：當執行go get命令時，提示“go: go.mod file not found in current directory or any parent directory.”。

這是由於運行go命令時無法在目前的目錄或其任何父目錄中找到go.mod檔案。go.mod檔案用於管理專案的依賴關係和版本控制，您可以通過以下命令初始化go.mod檔案。

# 在目前的目錄下初始化一個新的go.mod檔案。example.com/goproject定義模組路徑（通常為倉庫URL的路徑部分），網域名稱為example.com，專案名為goproject。
go mod init example.com/goproject