Pourquoi les photos HEIC perdent-elles leurs aperçus dans une galerie auto-hébergée ?
Les aperçus HEIC disparaissent lorsque la galerie ne peut pas décoder l’original, générer son image dérivée ou transmettre cette image au client actuel.
Une galerie auto-hébergée conserve normalement l’original HEIC tout en créant des miniatures et des aperçus JPEG ou WebP pour les navigateurs et les téléphones qui ne prennent pas directement en charge tous les profils HEIF. L’original peut rester téléchargeable même lorsque la chronologie est vide, car la corruption, un nouveau profil d’encodage du téléphone, des dimensions très importantes, l’absence de prise en charge du décodeur, l’échec des tâches des workers, des enregistrements de miniatures obsolètes ou le chargement de l’original côté client n’affectent que le processus de génération des dérivés. Diagnostiquez un fichier en suivant son parcours, des octets originaux jusqu’à l’aperçu généré.
Vérifier que le fichier HEIC original est intact
Téléchargez l’original depuis la galerie et comparez sa taille et son empreinte avec celles du téléphone source, de l’export ou de la sauvegarde. Ouvrez-le dans une application de bureau fiable prenant en charge le format HEIC.
Des utilisateurs d’Immich ont signalé que les téléversements HEIC et DNG cessaient ensuite de générer des miniatures et des aperçus. Il est donc important de distinguer un original endommagé d’un échec du processus de génération des dérivés. Le symptôme visible était l’absence de miniatures après le téléversement.
Si l’original téléchargé est tronqué ou corrompu, réparez le chemin de transfert et téléversez-le à nouveau depuis une source vérifiée. Si l’original s’ouvre correctement, conservez-le et poursuivez avec les vérifications des métadonnées, du décodeur et des tâches.
Comparer les métadonnées HEIC fonctionnelles et défaillantes
Choisissez un fichier HEIC qui génère des aperçus et un autre qui n’en génère pas. Comparez le modèle de l’appareil, la version du système d’exploitation, les dimensions, la profondeur de couleur, le profil colorimétrique, les images auxiliaires, l’orientation, les métadonnées HDR, la taille du fichier et les marques du conteneur.
Un nouveau logiciel de téléphone peut introduire un profil que le décodeur actuel du serveur ne comprend pas. Un problème Immich a révélé que des fichiers HEIC d’iOS 18 échouaient lors de la génération des miniatures avec des messages indiquant un en-tête incorrect, tandis que les anciennes images iOS fonctionnaient encore, ce qui isolait une différence liée au nouveau profil source.
Testez une autre photo du même téléphone après avoir modifié un réglage de l’appareil photo, uniquement pour caractériser l’échec. Ne convertissez pas et ne remplacez pas la bibliothèque originale avant de connaître le profil incompatible et la version du serveur concernés.
Vérifier les dimensions de l’image et les limites de ressources
Notez la largeur, la hauteur, le nombre de mégapixels, la taille du fichier et les images auxiliaires intégrées de l’image défaillante. Les fichiers HEIC très volumineux peuvent nécessiter beaucoup plus de mémoire lors du décodage que ne le laisse penser leur taille compressée.
Immich a documenté des fichiers HEIC de 200 mégapixels qui ne pouvaient pas produire de miniatures ni afficher d’aperçus. La limite pratique concernait des dimensions HEIC extrêmement importantes, et non la navigation ordinaire dans la galerie.
Surveillez la mémoire, le processeur, les limites du conteneur et les événements de manque de mémoire du worker de miniatures pendant le traitement d’un seul fichier. Si les images HEIC plus petites fonctionnent, augmentez les ressources disponibles pour le worker ou conservez une copie d’aperçu compatible sans supprimer l’original en pleine résolution.
Lire la première erreur de décodage du worker de miniatures
Lancez la tâche de génération des miniatures manquantes ou de régénération pour un seul fichier concerné et suivez le journal du microservice ou du worker. Capturez la première erreur de décodage, d’en-tête, d’espace colorimétrique, d’autorisation ou d’écriture, plutôt que l’échec générique final.
Des rapports Immich récents continuent de montrer des échecs de génération de miniatures pour certains fichiers HEIC après des mises à niveau. Un problème de 2026 identifie un échec du traitement HEIC lié à une mise à niveau.
Si chaque nouveau fichier échoue après la première erreur HEIC, redémarrez uniquement le worker défaillant après avoir conservé les journaux, puis vérifiez l’état de la file d’attente. Un seul fichier malformé ne doit pas masquer l’arrêt éventuel du processus worker, qui empêcherait la génération de tous les aperçus suivants.
Vérifier les bibliothèques de décodage et la compatibilité des versions
Notez la version de la galerie, l’image du conteneur, la bibliothèque de traitement d’image, le décodeur HEIF, l’architecture du processeur et les éventuelles modifications des versions propres au matériel lors de la mise à jour. Comparez-les avec le dernier déploiement connu comme fonctionnel.
Certaines défaillances HEIC ne concernent qu’un sous-ensemble d’images, même avec une seule version du serveur. Un problème Immich indique que seuls certains fichiers HEIC échouaient, ce qui indique une limite liée à une fonctionnalité du format plutôt qu’une absence complète de prise en charge du HEIC.
Testez le même original avec la version précédente de l’application ou avec une image de worker actuelle isolée. N’effectuez une restauration vers une version antérieure qu’à partir d’une sauvegarde cohérente de la base de données et de la configuration ; ne rétrogradez pas aveuglément la base de données de production pour tester un décodeur d’image.
Distinguer l’échec de l’aperçu côté serveur du chargement de l’original côté client
Ouvrez le fichier concerné dans le client web, l’application mobile et une session de navigation privée. Notez si la miniature de la chronologie, l’aperçu moyen, le dérivé en pleine taille et le téléchargement de l’original échouent indépendamment.
Un navigateur peut ne pas réussir à afficher l’original HEIC alors qu’un aperçu généré devrait fonctionner. Un problème Immich lié à Safari décrit l’échec du chargement de l’original HEIC, même lorsque le client pouvait utiliser un aperçu ou un dérivé en pleine taille.
Si un seul client échoue, effacez la réponse mise en cache pour ce fichier sur ce client et comparez les paramètres de chargement de l’original. Si aucun client ne dispose de la miniature et que le journal du worker n’indique aucun fichier généré, poursuivez le diagnostic côté serveur.
Régénérer uniquement les dérivés manquants après avoir corrigé la cause
Sauvegardez la base de données et le volume de métadonnées, puis exécutez la tâche de génération des miniatures manquantes sur un petit ensemble concerné. Vérifiez qu’elle crée de nouveaux dérivés sans remplacer les originaux.
Les versions d’Immich ont recommandé aux utilisateurs confrontés à des miniatures défectueuses d’exécuter la tâche de génération des miniatures manquantes après les correctifs concernés, ce qui favorise une régénération ciblée après réparation plutôt que la suppression préalable de l’ensemble du stockage des miniatures.
Le guide ZimaSpace consacré à la sauvegarde privée des photos d’iPhone rappelle l’exigence associée : préserver et vérifier les photos originales indépendamment des aperçus de la galerie.
Le problème est résolu lorsque l’empreinte de l’original reste inchangée, que le worker génère des miniatures pour le profil HEIC défaillant, que tous les clients pris en charge chargent le dérivé et qu’une nouvelle photo prise avec le même téléphone est correctement traitée sans reconstruire toute la bibliothèque.
Produits recommandés
Assistance et conseils
Plus à lire
Pourquoi la restauration d’un volume Docker recrée-t-elle le contenu des fichiers, mais supprime-t-elle les attributs étendus ?
Un diagnostic de restauration de volume couvrant l’inventaire des xattr, les options de tar et de Rsync, les espaces de noms, la prise en...
Pourquoi un conteneur en cours d’exécution conserve-t-il son ancienne limite de mémoire après la modification du fichier Compose ?
Un diagnostic des limites mémoire couvrant les cgroups actifs, le redémarrage par rapport à la recréation, les champs Compose, les limites strictes et souples,...
Pourquoi le redémarrage d’un proxy inverse invalide-t-il toutes les sessions d’une application auto-hébergée ?
Un diagnostic de perte de session couvrant la portée des redémarrages, la propriété des cookies, la rotation des secrets, les sessions adossées au cache,...
