Tous les produits
Search
Centre de documentation

:Gestion des délais d'expiration de connexion réseau

Dernière mise à jour :Aug 18, 2026

Introduction

Les utilisateurs du SDK OSS rencontrent fréquemment des délais d'expiration de connexion réseau lors du téléchargement (upload) de fichiers. Cette situation génère une erreur ConnectionTimeOut, ce qui dégrade l'expérience utilisateur.

Dépannage

Comme il est difficile de reproduire systématiquement ce problème, les causes possibles sont décrites ci-dessous pour vous aider à analyser et résoudre les délais d'expiration de connexion du SDK OSS.

  1. Environnement réseau

    Analysez le trajet réseau suivant :

    Téléphone mobile/PC --- Réseau de l'opérateur --- Serveur OSS

    Votre réseau peut se situer au niveau d'un nœud périphérique du réseau de l'opérateur. Par conséquent, les requêtes envoyées vers ce réseau sont plus susceptibles d'échouer. Utilisez les nœuds périphériques CDN pour accélérer les transferts et réduire la dépendance des téléphones mobiles et des PC vis-à-vis du réseau de l'opérateur. Le trajet réseau devient alors :

    Téléphone mobile/PC -- Nœud périphérique CDN le plus proche -- Réseau de l'opérateur -- Serveur OSS

    Si le problème persiste et que l'erreur ConnectionTimeOut continue de se produire, lisez l'analyse suivante.

  2. Configuration réseau

    Le code ci-dessous présente le message d'erreur détaillé relatif au délai d'expiration :

    "ConnectionTimeoutError&errormsg=Failed to upload some parts with error: ConnectionTimeoutError: 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

    Les conclusions suivantes peuvent être tirées de ce message d'erreur :

    • La connexion échoue car le client ne reçoit aucune réponse du serveur dans un délai de 60 secondes.

    • Selon les journaux CDN, le problème de délai d'expiration survient parce que la connexion réseau est interrompue avant le téléchargement complet d'une partie.

    • Dans des conditions réseau défavorables, si le fichier à télécharger est trop volumineux, le client ou le PC peut ne pas recevoir de réponse du serveur OSS pendant une longue période.

    Sur la base des conclusions précédentes, nous recommandons les solutions suivantes :

    • Utilisez la méthode de téléchargement multipartie (multipart upload) et limitez la taille maximale des parties à 1 Mo.

    • Ajoutez un mécanisme de reprise pour retélécharger les parties dont le téléchargement a échoué.

    • Augmentez la durée du délai d'expiration.

    // Code example of multipart upload in 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, // Set the part size.
        Timeout: 120000, // Set the timeout period.
      };
      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('');
          }
        }
      });
    };

Résumé

Lorsque vous accédez aux données OSS via un nom de domaine OSS standard (par exemple, oss-cn-hangzhou.aliyuncs.com), votre accès transite par le réseau de l'opérateur. Dans ce cas, une erreur ConnectionTimeOut peut survenir lors des téléchargements en raison d'environnements réseau complexes (tels qu'une instabilité ou de mauvaises conditions réseau). Essayez les solutions suivantes :

  • Utilisez la méthode de téléchargement multipartie et limitez la taille des parties entre 100 Ko et 1 Mo.

    Remarque

    Le serveur OSS n'accepte pas les parties inférieures à 100 Ko.

  • Ajoutez un mécanisme de reprise pour retélécharger les parties dont le téléchargement a échoué.

    Remarque

    Ce mécanisme est activé par défaut dans les SDK Android et iOS ; aucune configuration n'est donc requise.

  • Augmentez la durée du délai d'expiration.

  • Utilisez le service d'accélération CDN pour accélérer la transmission des données dans OSS.