常见问题

问题1：AttributeError: 'AttributeError' object has no attribute 'message'或”KeyError: 'ALIBABA_CLOUD_ACCESS_KEY_ID “？

可能的原因是您没有正确地设置阿里云的凭证（AccessKey）。

 config = open_api_models.Config(
            # 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID。,
            access_key_id=os.environ['yourAccessKeyID'],
            # 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。,
            access_key_secret=os.environ['yourAccessKeySecret']
        )

config = open_api_models.Config(
            # 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID。,
            access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            # 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。,
            access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
        )

• 检查您的环境变量中是否配置有ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。

• 在终端（Linux/macOS）或单击开始（或快捷键：Win+R）>运行（输入 cmd）>确定（或按 Enter 键），打开命令提示符（Windows），执行以下命令。若返回正确的AccessKey，则说明配置成功。如果返回为空或错误，请尝试重新设置，具体操作请参见设置访问凭据。

echo $ALIBABA_CLOUD_ACCESS_KEY_ID
echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET

echo %ALIBABA_CLOUD_ACCESS_KEY_ID%
echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%

问题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：使用Credentials工具时报错？

• 使用Credentials工具要求Python版本 >= 3.7。

• 使用V2.0代系的阿里云SDK。

pip install alibabacloud_credentials

问题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“？

超时的常见原因与解决步骤：

超时问题可能由多种因素引起，以下是一些常见的原因及相应的解决步骤：

1.网络连接问题

情况描述：客户端与服务器之间的网络不通或网络不稳定导致请求无法到达目标服务器。

解决方案：

• 使用命令ping [www.example.com/192.168.x.x]或curl -Is https://xxx.xxx.xx检查网络连通性。当遇到网络不通时，应在防火墙或路由器中检查是否有阻断策略；对于网络不稳定的情况，建议更换网络环境。

• 通过配置延长超时时间， 具体操作请参见超时机制。例如通过配置连接超时参数来延长连接超时时间，示例代码如下：

  # 对使用RuntimeOptions的请求生效
  runtimeOptions = RuntimeOptions(
      connect_timeout=5000  # 连接超时 单位毫秒(ms)
  )

2.API处理时间过长

情况描述：目标API处理请求的时间超过了设置的读超时时间。

解决方案：通过配置或增加超时时间来适应较长的API响应时间， 具体操作请参见超时机制。例如通过配置运行时参数（RuntimeOptions）来配置当前请求的超时时间，示例代码如下：

# 对使用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. 如果使用代理服务器，确保代理配置正确：

   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