¿Qué causa que las fotos HEIC pierdan las vistas previas en una galería autoalojada?
Las vistas previas HEIC desaparecen cuando la galería no puede decodificar el original, generar su imagen derivada o entregar dicha imagen al cliente actual.
Una galería autoalojada normalmente conserva el original HEIC mientras crea miniaturas y vistas previas JPEG o WebP para navegadores y teléfonos que quizá no muestren directamente todos los perfiles HEIF. El original puede seguir estando disponible para descarga aunque la línea de tiempo aparezca en blanco, porque la corrupción, un nuevo perfil de codificación del teléfono, dimensiones muy grandes, la falta de compatibilidad con el decodificador, trabajos fallidos del proceso, registros de miniaturas obsoletos o la carga del original en el cliente afectan únicamente a la ruta de las imágenes derivadas. Diagnostica un solo recurso, desde los bytes originales hasta la vista previa generada.
Confirma si el archivo HEIC original está intacto
Descarga el original desde la galería y compara su tamaño y hash con los del teléfono de origen, la exportación o la copia de seguridad. Ábrelo en una aplicación de escritorio de confianza compatible con HEIC.
Los usuarios de Immich han informado de cargas HEIC y DNG después de las cuales las miniaturas y las vistas previas dejaron de generarse, por lo que es importante separar un original dañado de un proceso de generación de derivados fallido. El síntoma visible fue la ausencia de miniaturas después de la carga.
Si el original descargado está truncado o dañado, corrige la ruta de transferencia y vuelve a cargarlo desde una fuente verificada. Si el original se abre correctamente, consérvalo y continúa con las comprobaciones de metadatos, decodificador y trabajos.
Compara los metadatos HEIC que funcionan con los que fallan
Elige un archivo HEIC que genere vistas previas y otro que no. Compara el modelo del dispositivo, la versión del sistema operativo, las dimensiones, la profundidad de bits, el perfil de color, las imágenes auxiliares, la orientación, los metadatos HDR, el tamaño del archivo y las marcas del contenedor.
El software nuevo del teléfono puede introducir un perfil que el decodificador actual del servidor no entiende. Un problema de Immich descubrió que los archivos HEIC de iOS 18 no generaban miniaturas y mostraban mensajes de encabezado incorrecto, mientras que las imágenes antiguas de iOS seguían funcionando, lo que aisló una diferencia en el nuevo perfil de origen.
Prueba otra foto del mismo teléfono después de cambiar únicamente un ajuste de la cámara para clasificar el fallo. No conviertas ni sobrescribas la biblioteca original hasta conocer el perfil incompatible y la versión del servidor.
Comprueba las dimensiones de la imagen y los límites de recursos
Registra el ancho, la altura, los megapíxeles, el tamaño del archivo y las imágenes auxiliares incrustadas de la imagen que falla. Los archivos HEIC muy grandes pueden requerir bastante más memoria durante la decodificación de lo que su tamaño comprimido sugiere.
Immich ha documentado archivos HEIC grandes de 200 megapíxeles que no podían generar miniaturas ni mostrar vistas previas. El límite práctico eran dimensiones HEIC extremadamente grandes, no la navegación habitual de la galería.
Supervisa la memoria, la CPU, los límites del contenedor y los eventos de falta de memoria del proceso de miniaturas mientras procesa un archivo. Si las imágenes HEIC más pequeñas funcionan, aumenta los recursos disponibles para el proceso o conserva una copia de vista previa compatible sin descartar el original en resolución completa.
Lee el primer error de decodificación del proceso de miniaturas
Ejecuta el trabajo de miniaturas ausentes o de regeneración para un recurso afectado y sigue el registro del microservicio o del proceso. Captura el primer error del decodificador, del encabezado, del espacio de color, de permisos o de escritura, en lugar del fallo genérico final.
Los informes recientes de Immich siguen mostrando fallos en la generación de miniaturas para archivos HEIC específicos después de las actualizaciones. Un problema de 2026 identifica un fallo de procesamiento HEIC asociado a una actualización.
Si todos los archivos nuevos fallan después del primer error HEIC, reinicia únicamente el proceso fallido después de conservar los registros y verifica el estado de la cola. No permitas que un solo recurso mal formado oculte si el proceso dejó de generar todas las vistas previas posteriores.
Verifica las bibliotecas del decodificador y la compatibilidad de versiones
Registra la versión de la galería, la imagen del contenedor, la biblioteca de procesamiento de imágenes, el decodificador HEIF, la arquitectura de la CPU y si las compilaciones específicas del hardware cambiaron durante la actualización. Compáralos con la última implementación conocida que funcionaba correctamente.
Algunos fallos HEIC afectan únicamente a un subconjunto de imágenes incluso dentro de una misma versión del servidor. Un problema de Immich informa de que solo ciertos archivos HEIC fallaban, lo que indica un límite relacionado con una función del formato y no una ausencia completa de compatibilidad con HEIC.
Prueba el mismo original con la versión anterior de la aplicación o con una imagen aislada del proceso actual. Revierte únicamente desde una copia de seguridad coherente de la base de datos y la configuración; no rebajes la base de datos de producción a ciegas para probar un decodificador de imágenes.
Separa el fallo de la vista previa del servidor de la carga del original en el cliente
Abre el recurso afectado en el cliente web, la aplicación móvil y una sesión privada del navegador. Registra si fallan de forma independiente la miniatura de la línea de tiempo, la vista previa mediana, el derivado a tamaño completo y la descarga del original.
Es posible que un navegador no pueda mostrar el original HEIC aunque la vista previa generada sí debería funcionar. Un problema de Immich en Safari describe un fallo al cargar el original HEIC, aunque el cliente podía recurrir a una vista previa o un derivado a tamaño completo.
Si solo falla un cliente, borra la respuesta del recurso almacenada en la caché de ese cliente y compara la configuración de carga del original. Si ningún cliente dispone de la miniatura y el registro del proceso no muestra ningún archivo generado, mantén el diagnóstico en el lado del servidor.
Regenera únicamente los derivados ausentes después de solucionar la causa
Haz una copia de seguridad de la base de datos y del volumen de metadatos; después, ejecuta el trabajo de miniaturas ausentes sobre un pequeño conjunto afectado. Confirma que crea nuevos derivados sin reemplazar los originales.
Las versiones de Immich han indicado a los usuarios con miniaturas dañadas que ejecuten el trabajo de miniaturas ausentes después de aplicar las correcciones pertinentes, lo que respalda la regeneración específica después de la reparación en lugar de eliminar primero todo el almacén de miniaturas.
La guía de ZimaSpace sobre la copia de seguridad privada de fotos del iPhone explica el requisito complementario: conservar y verificar las fotos originales de forma independiente de las vistas previas de la galería.
El problema está resuelto cuando el hash del original permanece sin cambios, el proceso genera miniaturas para el perfil HEIC que fallaba, todos los clientes compatibles cargan el derivado y una foto nueva del mismo teléfono se procesa correctamente sin reconstruir toda la biblioteca.
Productos recomendados
Soporte y Consejos
Más para leer
¿Por qué restaurar un volumen de Docker recrea el contenido de los archivos, pero elimina los atributos extendidos?
Un diagnóstico de restauración de volúmenes que abarca el inventario de atributos extendidos, las opciones de tar y Rsync, los espacios de nombres, la...
¿Por qué un contenedor en ejecución mantiene su antiguo límite de memoria después de cambiar el archivo de Compose?
Un diagnóstico del límite de memoria que abarca los cgroups activos, el reinicio frente a la recreación, los campos de Compose, los límites estrictos...
¿Por qué reiniciar un proxy inverso invalida todas las sesiones de una aplicación autoalojada?
Un diagnóstico de pérdida de sesión que abarca el alcance del reinicio, la propiedad de las cookies, la rotación de secretos, las sesiones respaldadas...
