常见问题_阿里云SDK(Alibaba Cloud SDK)-阿里云帮助中心

本文档旨在为开发者解答在使用.NET SDK过程中所遇到的常见问题，以提升开发效率。

环境检查

请确认已正确安装.NET运行环境，最低要求为.NET Framework ≥4.5或.NET Core ≥2.0

问题列表

问题1：AK传参问题。
问题2：运行时，提示“TimeoutException...”。
问题3：运行时，提示“Unhandled exception. System.ArgumentNullException: Value cannot be null. (Parameter 'key')”

问题1：AK传参问题。

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

V2.0 SDK：Unhandled exception. Tea.TeaException: 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：Unhandled exception. System.ArgumentOutOfRangeException: Specified argument was out of the range of valid values. (Parameter 'Access key ID cannot be null.')

解决方案：

执行以下命令，检查您的环境变量中是否配置有ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET：
Linux/macOS
Windows
```
echo $ALIBABA_CLOUD_ACCESS_KEY_ID
echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET
```
```
echo %ALIBABA_CLOUD_ACCESS_KEY_ID%
echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%
```
若返回正确的AccessKey，则说明配置成功。如果返回为空或错误，请尝试重新设置，具体操作请参见在Linux、macOS和Windows系统配置环境变量。

检查代码中AK相关内容是否存在错误。

常见的错误示例：

 AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config
            {
                AccessKeyId = Environment.GetEnvironmentVariable("yourAccessKeyID"),
                AccessKeySecret = Environment.GetEnvironmentVariable("yourAccessKeySecret"),
            };

正确示例：

 AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config
            {
                AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
            };

说明

Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID")和Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET")，表示是从环境变量中获取ALIBABA_CLOUD_ACCESS_KEY_ID及ALIBABA_CLOUD_ACCESS_KEY_SECRET的值。

重要

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

问题2：运行时，提示“TimeoutException...”。

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

网络连接问题

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

解决方案：

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

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

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

// 运行时参数设置，仅对使用了该运行时参数实例的请求有效
RuntimeOptions runtimeOptions = new RuntimeOptions();
runtimeOptions.ConnectTimeout = connectionTimeoutMillis;

API处理时间过长

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

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

// 运行时参数设置，仅对使用了该运行时参数实例的请求有效
RuntimeOptions runtimeOptions = new RuntimeOptions();
runtimeOptions.ReadTimeout = readTimeoutMillis;

问题3：运行时，提示“Unhandled exception. System.ArgumentNullException: Value cannot be null. (Parameter 'key')”

此问题的原因是credentials版本较低，建议升级Aliyun.Credentials到最新版本。

dotnet add package Aliyun.Credentials

C#语言基础异常自查表

报错信息	错误原因	解决方案
SocketException	发生与套接字相关的错误，如连接超时、连接被关闭等。	检查网络连接的可用性（可通过curl指令验证），并确保目标主机和端口号正确。
HttpRequestException	发生与 HTTP 请求相关的错误，如无法连接到服务器、请求超时等。	检查网络连接和服务器状态，确保服务器正常运行。可以使用 try-catch 块来捕获 HttpRequestException 并处理异常情况。
ProtocolViolationException	发生与网络协议相关的错误，如无效的 HTTP 请求或响应。	检查网络协议的规范，确保请求和响应符合协议要求。可以使用条件语句或异常处理机制来处理协议违规异常。
TimeoutException	操作在指定的时间内未完成，达到了超时时间。	增加操作的超时时间，或优化操作的性能以确保在指定的时间内完成。可以使用条件语句或异常处理机制来处理超时异常。
DNS resolution failure	无法解析域名或无效的域名。	检查域名的正确性，并确保 DNS 服务器可用。可以使用条件语句或异常处理机制来处理 DNS 解析失败。

技术支持

如果您在使用过程中遇到其他问题，请通过以下方式与我们联系：

提交工单：阿里云提交工单页面。
如果您有相关需求或反馈，可以添加钉钉群（群号为60965016010）联系技术支持人员。