Prueba un archivo RAW con el mismo decodificador fuera de la cola y, después, compara la asignación del trabajador y los registros del trabajo para distinguir entre incompatibilidad de formato y fallo de ejecución.
La decisión es importante cuando los archivos RAW originales se importan correctamente, pero las vistas previas permanecen en blanco o pendientes. Los dos estados en competencia son la decodificación RAW no compatible o fallida, y el fallo de la cola de miniaturas, del trabajador, de los permisos o del almacenamiento de salida. Comienza con una configuración guardada y datos desechables, observa una rama a la vez y detente si la prueba aumenta el riesgo de pérdida de datos, permisos o disponibilidad.
Distinguir entre la decodificación RAW no compatible o fallida y el fallo de la cola de miniaturas, del trabajador, de los permisos o del almacenamiento de salida
Registra el entorno antes de cambiar nada: versiones del software y del firmware, identidades de los dispositivos, ruta de montaje o red, espacio libre, permisos y síntoma observable. La línea base debe conservar suficientes detalles para reproducir que los archivos RAW originales se importan correctamente, pero las vistas previas permanecen en blanco o pendientes.
El primer candidato es la decodificación RAW no compatible o fallida. El segundo es el fallo de la cola de miniaturas, del trabajador, de los permisos o del almacenamiento de salida. Los tipos de medios compatibles con Immich actuales definen el mecanismo o límite de comandos utilizado en la prueba; no sustituyen la observación de este servidor doméstico específico.
Escribe la condición de aceptación y la condición de detención antes de ejecutar el discriminador. Una aprobación debe cambiar las evidencias previstas por una rama sin alterar otros servicios; un fallo debe devolver el sistema al estado guardado en lugar de activar una cadena de correcciones especulativas.
Ejecutar un discriminador controlado
Usa este discriminador: ejecuta pruebas de metadatos y decodificación en un RAW copiado, pon en cola un trabajo de miniatura y síguelo desde la cola hasta el archivo de salida. Mantén constantes la carga de trabajo, el cliente, la ruta, el conjunto de archivos y el momento para que el resultado pueda atribuirse a la variable modificada.
Usa la compatibilidad de decodificadores de libvips para seleccionar el campo que realmente pueda separar las ramas y, después, captura su marca de tiempo, estado de salida, texto del error, identidad del dispositivo o de la instantánea, latencia, bytes transferidos, permisos y estado de recuperación. Una salida limpia del comando no es suficiente cuando la identidad, la durabilidad o el estado de la aplicación son la afirmación que se está probando.
Repite la prueba una vez después de un reinicio, una reconexión, un nuevo montaje o una caché fría cuando ese evento forme parte de la condición original. Si la primera ejecución es destructiva o el entorno no puede restaurarse, detente y reproduce la prueba con una copia desechable.
exiftool sample.CR3
# Decodifica una copia con la pila de imágenes instalada y, después, pon en cola un trabajo de miniatura
Interpretar qué rama respaldan las evidencias
APROBADO: el decodificador falla antes de que se procese la cola, o la decodificación tiene éxito mientras el trabajador nunca escribe el derivado. Registra la versión, la identidad y la carga de trabajo exactas que produjeron la aprobación para que la conclusión siga siendo condicional en lugar de convertirse en una afirmación universal.
FALLIDO: solo falla una cámara o un modo de compresión, por lo que la compatibilidad debe limitarse a esa muestra. Un fallo no demuestra automáticamente la rama opuesta cuando la red, la memoria, los permisos o la coherencia del origen pueden influir en ambas; aísla esas dependencias compartidas antes de escalar.
RESULTADO EXCEPCIONAL O AMBIGUO: conserva los originales, detén las oleadas de reintentos y mantén una ruta de vistas previas JPEG que sepas que funciona mientras investigas. Conserva los registros y no ejecutes comandos de reparación, limpieza, destrucción, reparticionado o cambio recursivo de propietario hasta que exista una copia recuperable.
Aplicar la acción correspondiente y reproducir el fallo original
Aplica la acción correspondiente a la rama observada y, después, repite la condición original en lugar de utilizar un sustituto reducido. La decisión solo se mantiene cuando el decodificador falla antes de que se procese la cola, o cuando la decodificación tiene éxito mientras el trabajador nunca escribe el derivado, durante dos ciclos o durante el reinicio, suspensión, interrupción o transición de carga correspondiente.
Usa las bibliotecas de Immich de solo lectura para comprobar el flujo de trabajo dependiente más cercano, pero mantén sin cambios el desencadenante original. Los conjuntos de datos, recursos compartidos, contenedores, usuarios y puntos de recuperación no relacionados deben conservar su acceso y sus tiempos anteriores.
El límite de detención es explícito: si solo falla una cámara o un modo de compresión, la compatibilidad debe limitarse a esa muestra; vuelve a la última configuración verificada, conserva las evidencias y escala a una prueba más profunda de la plataforma o del hardware solo cuando la rama sea reproducible.
Cuando se mantenga el resultado objetivo, compáralo con la programación de trabajos de miniaturas para que la corrección no traslade el riesgo a un servicio cercano. Una prueba objetivo exitosa con un nuevo fallo de copia de seguridad, identidad, tiempo de espera o disponibilidad sigue siendo un cambio fallido.
Preguntas frecuentes
Para diagnosticar la falta de vistas previas RAW, las búsquedas restantes suelen centrarse en por qué funcionan algunos archivos RAW de una cámara, si los permisos de archivo pueden parecer correctos mientras los trabajadores siguen fallando y si deberían regenerarse las vistas previas de toda la biblioteca. Las respuestas siguientes mantienen esos casos límite separados de la decisión principal.
El límite de aceptación no cambia: el decodificador falla antes de que se procese la cola, o la decodificación tiene éxito mientras el trabajador nunca escribe el derivado. Si una condición posterior cambia el sistema de archivos, la identidad, la ruta de red o la versión de la aplicación, repite solo el discriminador afectado por ese cambio.
Deja de ampliar el experimento cuando solo falle una cámara o un modo de compresión, ya que la compatibilidad debe limitarse a esa muestra. En ese momento, conserva los originales, detén las oleadas de reintentos y mantén una ruta de vistas previas JPEG que sepas que funciona mientras investigas; conserva las evidencias antes de escalar al responsable de la plataforma, el almacenamiento o el hardware.
¿Por qué funcionan algunos archivos RAW de una cámara?
El firmware de la cámara, el modo de compresión, la vista previa incrustada y la versión del decodificador pueden diferir aunque tengan la misma extensión.
¿Pueden los permisos de archivo parecer correctos y aun así fallar los trabajadores?
Sí. El trabajador puede utilizar una ruta de contenedor, un UID o un montaje de salida diferentes.
¿Deberían regenerarse las vistas previas de toda la biblioteca?
No hasta que una muestra funcione y la capacidad disponible de la cola y del almacenamiento pueda absorber el trabajo.
El diagnóstico termina cuando la misma carga de trabajo hace que las evidencias sigan la decodificación RAW no compatible o fallida o el fallo de la cola de miniaturas, del trabajador, de los permisos o del almacenamiento de salida, y la acción correspondiente elimina el síntoma original sin crear otro. Si ninguna rama sigue siendo reproducible, conserva intactos los registros y el estado guardado; la incertidumbre es motivo para escalar, no para acumular más correcciones.
Soporte y Consejos
Más para leer

La carpeta compartida NAS muestra archivos antiguos después de reemplazar el almacenamiento: comprobaciones y soluciones
Compara el almacenamiento local con el recurso compartido activo y con un cliente limpio. Repara únicamente la capa que se haya demostrado obsoleta y,...

Guía de mantenimiento de refrigeración para mini PC: ventiladores, rejillas de ventilación y valores térmicos de referencia
Utiliza mediciones repetibles en reposo y bajo carga. Limpia primero el flujo de aire externo, confirma el funcionamiento del ventilador y abre el chasis...

Lista de comprobación de actualización del firmware del servidor doméstico para la BIOS, el orden de arranque y los dispositivos
Captura primero las versiones, las entradas UEFI y el estado del almacenamiento y del passthrough. Actualiza una capa a la vez y conserva el...

