问题描述

本文介绍如何处理在使用OSS SDK时可能出现的网络超时问题。

 

解决方案

使用SDK联网过程中出现超时,且在上传过程中提示ConnectionTimeOut错误,比较影响用户使用体验。

 

排查步骤

由于该问题无法复现,现列举以下可能的原因进行逐一排查,以解决OSS SDK的网络超时问题。

  • 网络环境相关排查思路,分析网络路径如下。
    手机或PC --- 运营商网络 --- OSS Server

    用户所在的网络环境可能处在运营商网络边缘节点,向运营商网络请求成功率比较低。可以利用CDN的边缘加速节点,减少手机或PC网络对运营商网络的依赖。具体链路如下。

    手机或PC -- CDN就近节点 -- 运营商网络 -- OSS Server

    具体的技术方案参见OSS如何开启CDN加速服务。如果问题没有完全解决,仍有ConnectionTimeOut的错误提示,请查看网络配置的分析。

  • 上传是动态请求,CDN加速效果不佳,建议用全站加速,全站加速对于动态请求有动态加速。另外建议增加下SDK如何设置是走CDN上传,以Java SDK为例,可以参考初始化文档,Endpoint设置为CDN的域名,然后配置文件开启CNAME。
    conf.setSupportCname(true);
    注:CNAME是指将自定义域名绑定到存储空间上。
  • 网络配置相关的排查思路,以下代码为具体的超时错误信息。
    "ConnectionTimeoutError&errormsg=Failed to upload some parts with error: ConnectionTimeout
    Error: Connect timeout for 60000ms, PUT https://***.oss-cn-hangzhou.aliyuncs.com/***/***/***.mp4?
    partNumber=2&uploadId=*** -2 (connected: false, keepalive socket: false)headers: {} part_num: 2

    从错误信息中可以得出如下结论 。

    • 超过60s没有收到服务器的返回信息而断开连接。
    • 尝试分析CDN提供的日志,确认超时的主要原因是分片还没上传成功,连接就已经断开。
    • 如果上传的文件较大,在弱网络环境下,客户端/PC端发送的请求迟迟得不到OSS服务器的响应。

    综合以上分析过程,现推荐以下几种解决方案。

    • 上传方式采用分片断点上传,每个分片的大小不超过1MB。
    • 添加重传机制,保证某一个分片上传失败后还可以继续上传。
    • 增大超时时间。

    相关代码如下所示。

    //js sdk 分片断点上传示例代码
    
    let retryCount = 0;
    let retryCountMax = 3;
    ...
    const uploadFile = function uploadFile(client) {
      if (!uploadFileClient || Object.keys(uploadFileClient).length === 0) {
        uploadFileClient = client;
      }
      ...
    
      console.log(`${file.name} => ${key}`);
      const options = {
        progress,
        partSize: 1000 * 1024,//设置分片大小
        timeout: 120000,//设置超时时间
      };
      if (currentCheckpoint) {
        options.checkpoint = currentCheckpoint;
      }
      return uploadFileClient.multipartUpload(key, file, options).then((res) => {
        console.log('upload success: %j', res);
        currentCheckpoint = null;
        uploadFileClient = null;
      }).catch((err) => {
        if (uploadFileClient && uploadFileClient.isCancel()) {
          console.log('stop-upload!');
        } else {
          console.error(err);
          //retry
          if (retryCount < retryCountMax){
              retryCount++;
              console.error("retryCount : " + retryCount);
              uploadFile('');
          }
        }
      });
    };

 

总结

如果通过标准OSS域名访问OSS的数据,且这是通过运营商网络对OSS进行访问,由于网络环境的复杂性,例如在一些弱网络环境下或网络不稳定的情况,就会在上传过程中遇到ConnectionTimeOut的网络错误。可以尝试通过以下方式来解决。

  • 采用分片断点上传,每个分片的大小不要超过1MB,也不要小于100KB。
    注:说明OSS服务器不接受小于100KB大小的分片。
  • 添加重传机制,保证某一个分片上传失败后还可以继续上传。
    注:说明Android/iOS SDK中已经默认开启,不需要额外配置。
  • 增大超时时间。
  • 通过CDN全站加速服务来提升OSS传输。详情请参见OSS如何开启CDN加速服务

 

适用于

  • 对象存储 OSS

 

如果您的问题仍未解决,您可以在阿里云社区提交工单联系阿里云技术支持。