常見問題
本文檔旨在幫助開發者快速接入和使用.NET SDK，重點解答使用過程中遇到的常見問題，確保開發者能夠準確且高效地進行相關操作。
環境檢查
確保 .NET語言環境已經正確安裝,最低要求net framework >= 4.5 或 .Net Core >= 2.0。
問題列表
問題1：代碼測試過程中提示未能獲取正確的憑證（Access Key ID 和 Access Key Secret）。
此問題主要原因是未正確設置Access Key ID和Access Key Secret的環境變量，或在測試中將這些值誤設為“null”。
System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")和System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")，表示是從環境變量中獲取ALIBABA_CLOUD_ACCESS_KEY_ID及ALIBABA_CLOUD_ACCESS_KEY_SECRET的值。
檢查您的環境變量中是否配置有ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
在終端（Linux/macOS）或單擊開始（或快捷鍵：Win+R）>運行（輸入 cmd）>確定（或按 Enter 鍵），打開命令提示符（Windows），執行以下命令。若返回正確的AccessKey，則說明配置成功。如果返回為空或錯誤，請嘗試重新設置，具體操作請參見設置訪問憑據。
Linux/macOS
echo $ALIBABA_CLOUD_ACCESS_KEY_ID
echo $ALIBABA_CLOUD_ACCESS_KEY_SECRETWindows
echo %ALIBABA_CLOUD_ACCESS_KEY_ID%
echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%問題2：運行時，提示“TimeoutException...”。
超時問題可能由多種因素引起，以下是一些常見的原因及相應的解決步驟：
網絡連接問題
情況描述：客戶端與服務器之間的網絡不通或網絡不穩定導致請求無法到達目標服務器。
解決方案：
使用命令
ping [www.example.com/192.168.x.x]或curl -Is https://xxx.xxx.xx檢查網絡連通性。當遇到網絡不通時，應在防火墻或路由器中檢查是否有阻斷策略；對于網絡不穩定的情況，建議更換網絡環境。通過配置延長超時時間， 具體操作請參見超時配置。例如通過配置連接超時參數來延長連接超時時間，示例代碼如下：
// 運行時參數設置，僅對使用了該運行時參數實例的請求有效
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到1.3.4及以上。
dotnet add package Aliyun.CredentialsC#語言基礎異常自查表
報錯信息 | 錯誤原因 | 解決方案 |
SocketException | 發生與套接字相關的錯誤，如連接超時、連接被關閉等。 | 檢查網絡連接的可用性（可通過curl指令驗證），并確保目標主機和端口號正確。 |
HttpRequestException | 發生與 HTTP 請求相關的錯誤，如無法連接到服務器、請求超時等。 | 檢查網絡連接和服務器狀態，確保服務器正常運行?？梢允褂?try-catch 塊來捕獲 HttpRequestException 并處理異常情況。 |
ProtocolViolationException | 發生與網絡協議相關的錯誤，如無效的 HTTP 請求或響應。 | 檢查網絡協議的規范，確保請求和響應符合協議要求?？梢允褂脳l件語句或異常處理機制來處理協議違規異常。 |
TimeoutException | 操作在指定的時間內未完成，達到了超時時間。 | 增加操作的超時時間，或優化操作的性能以確保在指定的時間內完成。可以使用條件語句或異常處理機制來處理超時異常。 |
DNS resolution failure | 無法解析域名或無效的域名。 | 檢查域名的正確性，并確保 DNS 服務器可用?？梢允褂脳l件語句或異常處理機制來處理 DNS 解析失敗。 |
技術支持
以上問題的解決方案旨在幫助您更友好地使用阿里云SDK。如果您在使用過程中遇到其他問題，請通過以下方式與我們聯系：
提交工單：阿里云提交工單頁面。
如果您有相關需求或反饋，可以添加釘釘群聯系阿里云技術支持人員，群號為60965016010。