Pourquoi Immich renvoie-t-il des erreurs intermittentes lors de l’importation de grandes bibliothèques mobiles ?

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

Les erreurs intermittentes d’Immich pendant une importation mobile volumineuse indiquent généralement qu’une couche échoue en situation de chevauchement, et non que toute la bibliothèque ou chaque fichier téléversé est corrompu.

Les importations volumineuses sollicitent simultanément le fonctionnement en arrière-plan des appareils mobiles, les requêtes de longue durée, les limites du proxy inverse ou du tunnel, les écritures en base de données, les E/S de stockage, le traitement des miniatures et des vidéos, ainsi que les files de tâches d’apprentissage automatique. Commencez par relever un petit groupe de fichiers en échec et leurs horodatages. Déterminez ensuite si l’échec survient sur le téléphone, le chemin réseau, le serveur d’application ou une dépendance saturée.

Classer le groupe d’erreurs avant de tout réessayer

Regroupez les échecs par type de média, taille de fichier, appareil source, chemin réseau et heure. Si seuls les gros fichiers vidéo échouent, examinez la durée des requêtes et les limites de téléversement avant le processeur. Si des photos et des vidéos échouent de façon aléatoire aux mêmes heures de forte activité, les ressources partagées du serveur ou l’instabilité du réseau deviennent des causes plus probables.

Un signalement d’utilisateur d’Immich datant de 2026 et décrivant de nombreuses erreurs de téléversement mobile est utile, car il montre comment un important arriéré de photos sur un téléphone peut entraîner des échecs répétés nécessitant un diagnostic pour chaque élément et chaque chemin. Il ne prouve pas l’existence d’un bogue universel du client mobile.

Ne choisissez pas « tout réessayer » comme première action de diagnostic. Enregistrez les noms ou identifiants de dix fichiers ayant échoué, un élément témoin ayant réussi et la période correspondante dans les journaux du client et du serveur. Un petit groupe connu vous permet de tester des modifications sans provoquer une nouvelle avalanche qui masquerait les indices d’origine.

Comparer les téléversements locaux au chemin distant habituel

Téléversez les mêmes fichiers de test, petits et volumineux, sur un réseau Wi-Fi local stable, directement vers le point de terminaison local de confiance, puis recommencez via le nom d’hôte distant habituel, le VPN, le tunnel ou le proxy inverse. Gardez le même compte et le même fichier pour que le chemin réseau soit la principale variable.

Un signalement de échecs de sauvegarde de fichiers volumineux montre pourquoi les limites de requête du proxy ou du tunnel doivent être examinées dans cette branche du diagnostic. Le service concerné et les seuils signalés dépendent du déploiement ; le test général consiste à vérifier si le transfert local direct réussit alors que le chemin distant échoue de façon systématique.

Si les deux chemins échouent pour les mêmes fichiers, examinez les données du serveur et du stockage. Si seul le chemin distant échoue, vérifiez la taille maximale du corps de requête, la mise en mémoire tampon des requêtes, les délais d’inactivité et de lecture, la terminaison TLS, les changements de réseau mobile et les retransmissions. Modifier la concurrence de génération des miniatures ne corrigera pas une requête qui n’atteint jamais complètement Immich.

Corréler les erreurs à la croissance de la file d’attente et à la pression sur les ressources

Les importations volumineuses peuvent continuer à accepter des téléversements tandis que les tâches en arrière-plan s’accumulent. Pendant la période de panne, surveillez le processeur, la pression sur la mémoire, la latence des E/S de blocs, la réactivité de la base de données, les redémarrages de conteneurs et l’achèvement des tâches. Une utilisation élevée à elle seule ne constitue pas une preuve ; la métrique doit varier en même temps que les erreurs.

L’article sur la surveillance des ressources Docker et les métriques de processeur, de mémoire, de réseau et de disque des conteneurs montre l’intérêt de comparer les conteneurs plutôt que de se fier à une seule moyenne à l’échelle de l’hôte. Sous Linux, associez les métriques des conteneurs aux données de stockage de l’hôte et aux signes de pression mémoire relevés aux mêmes moments.

Si la pression sur la mémoire provoque l’arrêt de conteneurs, si la latence du stockage augmente avec les erreurs de téléversement ou si le temps de réponse de la base de données grimpe pendant que la file cesse d’avancer, réduisez uniquement la charge de travail ou la concurrence responsable, puis répétez le test avec la cohorte de référence. Si les graphiques des ressources restent stables, poursuivez avec les journaux de l’application et le diagnostic du chemin réseau.

Considérez le taux d’erreur et la latence de queue comme des indicateurs de charge

Un système peut sembler sain d’après son temps de réponse moyen, alors qu’un faible pourcentage des requêtes expire pendant les pics. Pendant une période contrôlée, consignez le nombre de téléversements tentés, les échecs, le temps de réponse médian et les requêtes les plus lentes. Vous pourrez ainsi mesurer les interruptions au lieu de vous fier à des anecdotes.

Le cadre de test de charge présenté dans l’analyse des erreurs et de la latence recommande d’analyser les catégories de codes d’état, les problèmes de connexion, les distributions et les corrélations dans le temps. Il n’est pas nécessaire de soumettre la bibliothèque familiale à une forte charge ; appliquez la même méthode d’analyse au débit d’import réel.

Si la réduction du débit d’arrivée diminue fortement les échecs alors que chaque fichier réussit individuellement, la pile actuelle manque de marge pour cette intensité d’import. Si les mêmes fichiers échouent même un par un, le problème est propre aux fichiers, au chemin d’accès ou à un bogue logiciel déterministe, plutôt qu’à une saturation générale.

Réduisez une source de pression et relancez le même schéma d’import

Choisissez la modification la plus sûre au vu des éléments disponibles : réduisez d’un cran la concurrence en arrière-plan, mettez en pause un autre conteneur gourmand, utilisez le chemin local, lancez l’import en dehors d’une période de sauvegarde ou corrigez le délai d’expiration du proxy. Ne modifiez pas simultanément les limites du processeur, le stockage, les règles du proxy et les versions de l’application.

Le flux de travail ZimaSpace pour les interruptions de la sauvegarde des photos du téléphone couvre la branche côté mobile : la planification en arrière-plan, les originaux disponibles uniquement dans le cloud et les changements de conditions réseau peuvent interrompre les téléversements même lorsque le serveur fonctionne correctement.

Continuez si la cohorte de référence réussit et que le même import de plus grande taille s’exécute avec un taux d’erreur stable, des files d’attente qui avancent et des performances interactives acceptables. Faites remonter le problème si les échecs persistent à faible charge ou se répètent sur des fichiers identiques ; joignez les journaux du client et du serveur, l’état du proxy, les graphiques des ressources, le type et la taille des fichiers, ainsi que la première requête en échec.

Assistance et conseils

À lire aussi

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.