Alibaba Cloud SDK：常見問題

問題1：AK傳參問題。

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

• V2.0 SDK：AttributeError: 'NoneType' object has no attribute 'get_access_key_id'.

• V1.0 SDK：Error:MissingParameter The input parameter "AccessKeyId" that is mandatory for processing this request is not supplied.

解決方案：

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 = open_api_models.Config(
               access_key_id=os.environ['yourAccessKeyID'],
               access_key_secret=os.environ['yourAccessKeySecret']
           )

   正確樣本：

    config = open_api_models.Config(
              access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
              access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
           )

   說明

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

   重要

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

問題2：SDK安裝失敗？

• 確保使用了正確的Python版本（如Python 3.x）。

• 使用pip安裝時加上--upgrade選項，確保安裝最新版本：

pip install --upgrade <SDK_NAME>  

• 如果在安裝過程中遇到許可權問題（比如在系統層級的Python庫路徑下安裝時），可以使用--user選項，這將SDK安裝到使用者目錄中，而不是系統目錄：

pip install --user <SDK_NAME>  

• 如果你在同一台機器上安裝了多個版本的Python，確保你在使用的Python版本中安裝了SDK。例如，使用python3而不是python，確保對應的pip也使用了pip3。

問題3：匯入模組失敗，ModuleNotFoundError？

確保SDK已經正確安裝，可以在Python環境下嘗試匯入：

• 開啟python解譯器

python

• 匯入模組

import <SDK_NAME> 

如果沒有任何錯誤，說明SDK已正確安裝。如果出現`ModuleNotFoundError`或`ImportError`，說明SDK未正確安裝。

pip install <SDK_NAME>

問題4：AttributeError: 'CredentialModel' object has no attribute 'provider_name'

問題5：code: 400, The input parameter"AccesskeyId" that is mandatory for processing this request is not supplied？

• 引發該錯誤直接原因是發到網關的請求沒有攜帶AccesskeyId。

• 您需要檢查在使用openapi門戶下載的完整工程時AccesskeyId是否放到了錯誤的位置。應替換main方法下accessKeyId和accessKeySecret兩個字串。

問題6：Tea.exceptions.TeaException: Error: SignatureDoesNotMatch.MissingHeader code: 400, The specified signed header "accept;connection;content-type;host;user-agent;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version" is not found？

引發該錯誤直接原因是自簽名調用服務時通過設定header {"Connection":"close"}以實現短串連，但是V3簽名對此不相容，從而導致報錯。

您可以通過設定：config.signature_algorithm = 'v2'來解決。

問題7：Tea.exceptions.TeaException: Connection aborted？

導致該錯誤的直接原因是請求間隔過長。長串連服務端僅保持30秒，而用戶端則持續保持串連，這導致在經歷30秒的間隔後，請求被服務端斷開，進而導致請求失敗。

• 設定header {"Connection":"close"}以實現短串連。

• 可以配置重試，維持在30s內有一次調用。

問題8：調用API逾時，提示：”requests.exceptions.Timeout“或”requests.exceptions.ConnectionError“？

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

網路連接問題

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

解決方案：

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

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

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

• # 對使用RuntimeOptions的請求生效
  runtimeOptions = RuntimeOptions(
      connect_timeout=5000  # 連線逾時 單位毫秒(ms)
  )

2.API處理時間過長

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

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

# 對使用RuntimeOptions的請求生效
runtimeOptions = RuntimeOptions(
    read_timeout=10000,  # 讀逾時時間 單位毫秒(ms)
)

問題9：Linux系統：-bash: python3: command not found？

如果您已安裝了Python，則可能是軟串連沒有配置正確。

• 執行which python3 pip3尋找當前系統是否存在軟串連，如果存在，需要刪除軟串連。

rm -rf /usr/bin/python3 /usr/bin/pip3

• 重新建立軟串連。找到Python的安裝目錄，進入bin目錄，找到pip3.12和python3.12。執行下面命令建立新軟串連。

sudo ln -s /usr/local/python3/bin/python3.12 /usr/bin/python3
sudo ln -s /usr/local/python3/bin/pip3.12 /usr/bin/pip3

問題10：調用API時返回“Invalid parameters”錯誤或”MissingRequiredParameter“類型錯誤？

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

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

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

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

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

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

send_sms_request = dysmsapi_20170525_models.SendSmsRequest(
            # 需要替換成為您接收簡訊的手機號碼
            phone_numbers='<YOUR_VALUE>',
            # 需要替換成為您的簡訊簽名
            sign_name='<YOUR_VALUE>',
            # 需要替換成為您的簡訊模板code
            template_code='<YOUR_VALUE>',
            # 樣本值：{"code":"1234","name":"1234","time":"1234"}為Json格式
            template_param='{"code":"1234","name":"1234","time":"1234"}'
        )

問題11：API 呼叫失敗，提示地區不支援，報錯”Tea.exceptions.UnretryableException“？

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

問題12：File "/usr/local/python3/lib/python3.6/site-packages/alibabacloud_slb20140515/client.py", line 4, in <module> from Tea.core import TeaCore ModuleNotFoundError: No module named 'Tea'？

引發該錯誤的原因是由於PIP版本過舊，導致依賴包安裝不完整，或部分依賴包已被刪除。您可以通過升級PIP並再次執行pip install <產品包>來解決此問題，或者安裝缺失的Tea包，使用命令pip install alibabacloud-tea。

問題13：報錯：Command "python setup.py egg_info" failed with error code 1 in xxx？

引發該錯誤的原因是由於Python版本或pip版本過低或者缺少相應的開發庫（擴充包），導致在安裝SDK後無法正常使用。

解決方案：

1. 檢查 SSL/TLS 協議版本：確保本地 Python 環境支援與伺服器通訊所需的 SSL/TLS 版本（例如，伺服器可能僅支援 TLS 1.2）。

   import ssl
   import urllib3
   
   # 建立一個 SSL 上下文，使用 TLS 1.2
   ssl_context = ssl.create_urllib3_context(ssl.OP_NO_SSLv2, ssl.OP_NO_SSLv3, ssl.OP_NO_TLSv1, ssl.OP_NO_TLSv1_1)
   
   # 初始化 urllib3 池管理器
   http = urllib3.PoolManager(context=ssl_context)
   
   # 發送請求
   response = http.request('GET', 'https://ocr-api.cn-hangzhou.aliyuncs.com/?Country=Vietnam')
   

2. 檢查 Python 環境問題：

   1. 確保 ssl 模組和 urllib3 庫的版本與 Python 版本相容。

   2. 使用虛擬環境重新安裝 Python 和相關依賴：

   python -m venv myenv
   source myenv/bin/activate
   pip install requests urllib3 pyOpenSSL

3. 檢查網路設定問題，

   1. 確保本地防火牆允許 HTTPS 連接埠（443）的流量。

   2. 如果使用Proxy 伺服器，確保代理配置正確：

   import requests
   
   # 使用代理
   proxies = {
       'http': 'http://your-proxy-server:port',
       'https': 'https://your-proxy-server:port'
   }
   
   response = requests.get(
       'https://ocr-api.cn-hangzhou.aliyuncs.com/?Country=Vietnam',
       proxies=proxies
   )

4. 通過升級 requests 和 urllib3 庫來解決問題。

   pip install --upgrade requests urllib3

5. 如果在升級後仍然出現錯誤，則可能是由於環境認證的問題。請設定以下參數以忽略認證，同時調整逾時時間。

   # 忽略認證驗證
   runtimeOptions = RuntimeOptions(
    ignore_ssl=True # 忽略對 SSL 憑證的驗證，預設驗證
   )
   
   # 調整逾時時間
   runtimeOptions = RuntimeOptions(
       read_timeout=xxx,  # 讀逾時時間 單位毫秒(ms)
       connect_timeout=xxx  # 連線逾時 單位毫秒(ms)
   )

6. 若在忽略認證後仍然出現錯誤，請將環境變數 PYTHONHTTPSVERIFY 設定為 0，以強制忽略 SSL 驗證。

   export PYTHONHTTPSVERIFY=0  # 忽略 HTTPS 驗證

7. 檢查本地 SSL 憑證：確保本地裝置上的 SSL 憑證是最新且完整的。可以使用工具（如 certbot）更新認證或安裝缺失的認證。

   sudo certbot certonly --standalone --rsa-key-size 4096 --agree-tos --email yo**@email.com