常见问题

问题1：设置访问凭据环境变量后，仍然无法认证。Cannot read properties of undefined (reading 'getCredential')或”InvalidAccessKeyId.NotFound: code: 404“？

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

• 错误示例：

 let config = new OpenApi.Config({
      // 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID。
      accessKeyId: process.env['LTAI5tA******'],
      // 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
      accessKeySecret: process.env['0wpTxkN******'],
    });

• 正确示例：

let config = new OpenApi.Config({
      // 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID。
      accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
      // 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
      accessKeySecret: process.env['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：调用API超时，提示：”Error: connect ETIMEDOUT“？

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

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

1.网络连接问题

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

解决方案：

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

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

  JavaScript示例

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

  TypeScript示例

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

2.API处理时间过长

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

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

// 创建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：使用 npm install 时报错？

确保 Node.js 和 npm 已正确安装。使用以下命令清理 npm 缓存，然后重新安装。具体操作步骤请参见安装Node.js。

npm cache clean --force

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

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

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

 rm -rf node_modules package-lock.json
 npm install