常见问题

问题1：AK传参问题。

问题现象：代码运行时报错，报错信息中包含如下信息时，表示AK未正确地设置阿里云的凭证（AccessKey）。

• V2.0 SDK：Cannot read properties of undefined (reading 'getCredential').

• V1.0 SDK：AssertionError [ERR_ASSERTION]: must pass "config.accessKeyId".

解决方案：

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相关内容是否存在错误。

   常见的错误示例：

    let config = new OpenApi.Config({
         accessKeyId: process.env['yourAccessKeyID'],
         accessKeySecret: process.env['yourAccessKeySecret'],
       });

   正确示例：

   let config = new OpenApi.Config({
         accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
         accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
       });

   说明

   process.env['ALIBABA_CLOUD_ACCESS_KEY_ID']和process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET']

   ，表示是从环境变量中获取ALIBABA_CLOUD_ACCESS_KEY_ID及ALIBABA_CLOUD_ACCESS_KEY_SECRET的值。

   重要

   切勿直接在线上代码中明文写入 AccessKey，该写法存在安全隐患。

问题2：调用API超时，提示：”Error: connect ETIMEDOUT“？

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

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

1.网络连接问题

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

解决方案：

使用ping或curl命令测试本地主机与云产品Endpoint之间连通性，例如调用发送短信接口超时时，使用ping dysmsapi.aliyuncs.com或curl -v https://dysmsapi.aliyuncs.com测试连通性。

• 若命令执行超时或者无响应，请检查本地防火墙或路由器中是否有阻断策略。

• 若命令有响应，建议设置合理的超时时间，避免因配置不当导致请求失败，具体操作请参见超时机制。示例代码如下：

  JavaScript示例

  // 创建RuntimeObject实例并设置运行参数。
      const runtime = new RuntimeOptions({
          // 设置连接超时时间
          connectTimeout: 10000,
      });

  TypeScript示例

   // 创建RuntimeObject实例并设置运行参数。
          const runtime = new $Util.RuntimeOptions({
              // 设置链接超时时间
              connectTimeout: 10000,
          });

2.API处理时间过长

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

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

// 创建RuntimeObject实例并设置运行参数。
    const runtime = new RuntimeOptions({
        // 设置读取超时时间
        readTimeout: 10000,
    });

 // 创建RuntimeObject实例并设置运行参数。
        const runtime = new $Util.RuntimeOptions({
            // 设置读取超时时间
            readTimeout: 10000,
        });

问题3：调用API时发生”MissingRequiredParameter“类型错误？

这里以调用短信服务的发送短信接口为例：

• 进入OpenAPI门户的API调试页面，选择云产品和接口。

• 仔细对比构造的请求对象（如 SendSmsRequest）是否填充了所有必需字段，例如手机号、签名等。

• 参考API文档确认必填项。确保必填参数值正确。

• 确保填写的必填参数值正确无误，例如手机号格式是否符合要求。

• 在调用 API 前，SDK 会对参数进行自动校验。如果缺少必要参数，您将收到类似 MissingRequiredParameter 的错误提示。例如，如果手机号参数缺失，会报错 “MissingPhoneNumbers: code: 400”。

let sendSmsRequest = new Dysmsapi20170525.SendSmsRequest({
      phoneNumbers: '<YOUR_VALUE>',
      signName: '<YOUR_VALUE>',
      templateCode: '<YOUR_VALUE>',
    });

let sendSmsRequest = new $Dysmsapi20170525.SendSmsRequest({
      phoneNumbers: "<YOUR_VALUE>",
      signName: "<YOUR_VALUE>",
      templateCode: "<YOUR_VALUE>",
    });

问题4：API 调用失败，提示区域不支持，报错”getaddrinfo ENOTFOUND“系统无法找到指定的主机名称？

确保您所选区域支持您正在调用的服务。这里以短信服务为例，查看产品的Endpoint可以通过OpenAPI 开发者门户的产品主页中进行查找确认，请确保填写正确的Endpoint。

问题5：安装SDK时， npm install 报错？

首先确保 Node.js 和 npm 已正确安装，具体操作步骤请参见安装Node.js。

问题6：依赖包版本出现冲突？

• 使用npm ls命令查看依赖树，确保没有版本冲突。

• 可以删除node_modules目录和package-lock.json文件，并重新安装依赖：

 rm -rf node_modules package-lock.json
 npm install