全部產品
Search
文件中心

Object Storage Service:訪問OSS出現網路異常如何處理?

更新時間:Jun 16, 2026

發生網路異常有可能是您使用的OSS網域名稱不合適,但多數網路異常都是用戶端網路不穩定導致的,本文將針對不同情況給出網路異常的解決辦法。

背景資訊

如果您請求OSS時收到了OSS的響應,即使這個響應的HttpCode不是200,也說明您當前的網路跟OSS服務之間是連通的。這類問題您只需擷取OSS響應中的Request ID,開啟OSS自助診斷工具進行問題診斷檢測即可。關於如何擷取Request ID,請參見擷取Request ID。

本文所示的網路異常是指您的請求沒有到達OSS的伺服器之前就發生了中斷,您可以通過擷取Request ID來判斷您的請求有沒有到達OSS,請求沒有到達OSS時Request ID為空白。

Connection refused

問題原因

  • 您的用戶端和OSS不在同一地區的阿里雲內網中。只有在與OSS同地區的阿里雲產品中才可以通過內網Endpoint訪問OSS,比如您有一個cn-hangzhou的OSS Bucket,則可以在一台cn-hangzhou的ECS上通過oss-cn-hangzhou-internal.aliyuncs.com網域名稱訪問OSS。關於網域名稱的更多資訊,請參見地區和Endpoint。

  • 用戶端跟OSS雖然在同一個地區,但是用戶端可能有一些特殊限制,比如連接埠未開放等。

  • 從海外直接存取中國內地的OSS Endpoint,或從中國內地訪問海外OSS Endpoint,可能因跨境網路鏈路不穩定導致連線逾時或被拒絕。

解決方案

  • 檢查您的網域名稱中是否帶internal,改用不帶internal的公網Endpoint發起請求。如果公網Endpoint可以正常請求,說明您當前的用戶端不適合使用內網Endpoint。

  • 建議在出現問題的用戶端通過ping命令訪問OSS的公網Endpoint地址,比如:ping oss-cn-hangzhou.aliyuncs.com,如果無法ping通請使用telnet命令測試80/443連接埠是否正常。

  • 如果存在跨境訪問情境,建議開啟OSS傳輸加速功能,使用傳輸加速網域名稱(oss-accelerate.aliyuncs.com)訪問OSS,提升跨地區資料轉送的穩定性和速度。更多資訊,請參見通過傳輸加速訪問OSS。

ConnectionTimeOut

問題原因

  • 您所在的網路環境可能處在電訊廠商網路邊緣節點,向電訊廠商網路請求成功率比較低。

  • 上傳大檔案逾時。

  • 配置的逾時時間過短。

解決方案

關於網路逾時處理的更多資訊,請參見Handling network timeouts。

Socket timeout or Socket closed

問題原因

串連OSS逾時。

解決方案

增大逾時時間。例如,Java SDK可以通過ClientConfiguration.setSocketTimeout設定Socket層傳輸資料的逾時時間。更多SDK範例程式碼,請參見簡介。

Connection reset

問題原因

  • 用戶端網路異常。

  • 代碼中配置的Endpoint不準確。

  • 因攻擊或者發布違法內容的原因導致Bucket被切入沙箱。

  • OSS網域名稱被電訊廠商劫持。

解決方案

  • 排查用戶端網路是否正常

    在出現報錯的裝置上通過ping命令訪問所在地區的OSS訪問網域名稱,或者開啟阿里崑崙診斷工具查看您的網路是否有異常。當網路異常時請排查解決。

  • 排查代碼配置

    在用戶端網路正常的前提下,通過ping命令存取碼中使用的OSS網域名稱,確保網域名稱拼字正常。關於網域名稱的更多資訊,請參見地區和Endpoint。

    說明

    代碼中的Endpoint必須要帶HTTP或HTTPS協議頭,比如:https://oss-cn-hangzhou.aliyuncs.com。

    更多SDK範例程式碼,請參見簡介。

  • 確認Bucket是否進入沙箱

    進入沙箱的表現為部分請求可以正常響應,但服務品質將被降級。更多資訊,請參見OSS沙箱。

  • 抓包排查

    如果經過上述排查後仍未解決您的問題,請使用Wireshark工具抓包後聯絡OSS支援人員進行排查。