Error al cargar el modelo: no se encuentra, no se reconoce, arquitectura no compatible
Los errores de carga de modelos de ComfyUI suelen dividirse en tres tipos: archivo no encontrado, archivo no reconocido y arquitectura no compatible. La dirección del diagnóstico es completamente distinta para cada tipo, así que primero determina a cuál pertenece tu caso y luego sigue los tres pasos siguientes; no empieces descargando de nuevo sin más. Antes de empezar, se recomienda repasar la verificación rápida de 60 segundos de la visión general de solución de problemas.
Síntomas
Compara con las tres manifestaciones siguientes para determinar el tipo de tu problema:
- La lista desplegable de modelos del nodo está vacía, o no ves el modelo que acabas de colocar; lo más probable es que sea un problema de rutas.
- En tiempo de ejecución muestra
Value not in list: ckpt_name: 'model-name.safetensors' not in [](no se encuentra el modelo especificado); el archivo no está en las rutas de búsqueda. - Al generar se muestran errores de dimensiones de tensor o de shape no coincidentes; arquitectura no compatible.
Comprobación rápida (60 segundos)
- ¿Está el archivo en el subdirectorio del tipo correspondiente bajo
ComfyUI/models/? Los checkpoints van encheckpoints/, las LoRA enloras/, las VAE envae/. - ¿Está la extensión en la lista de formatos compatibles de ComfyUI (los más comunes
.safetensors/.ckpt)? ¿El tamaño del archivo coincide con la página de publicación oficial? - Pulsa una vez el botón de refrescar de la interfaz (Refresh) o reinicia ComfyUI, y vuelve a mirar la lista desplegable.
Pasos de diagnóstico
Paso 1: confirmar las rutas de búsqueda
Error: Value not in list: ckpt_name: 'model-name.safetensors' not in [] (no se encuentra el modelo especificado)
Solución: coloca el modelo en el subdirectorio del tipo correspondiente, o haz que ComfyUI lea tu directorio personalizado. Colocar el archivo en el directorio de tipo equivocado es la causa más común: si metiste un checkpoint en loras/, es lógico que no aparezca en la lista desplegable. Si tienes los modelos concentrados en otro disco, debes registrar las rutas de búsqueda adicionales en extra_model_paths.yaml (la sintaxis de configuración se explica en Dónde colocar los modelos: directorio models y extra_model_paths en detalle); tras el cambio, reinicia ComfyUI para que surta efecto.
Paso 2: confirmar que el archivo está completo y con formato correcto
Error: Error while deserializing header (archivo de modelo no reconocido / resultado de la carga vacío)
Solución: sospecha primero del propio archivo; vuelve a descargarlo y verifica el tamaño. Una descarga interrumpida deja archivos dañados; confirma que la extensión esté en la lista de formatos compatibles de ComfyUI (.safetensors, .ckpt, .pt, .pth, .bin, etc.; la lista completa está en Dónde colocar los modelos); si el nombre del archivo contiene caracteres especiales o chinos, cámbialo por solo letras y números latinos y vuelve a refrescar la lista @@I18N_KEEP_000014@@.
Paso 3: tratar la arquitectura no compatible
Error: The size of tensor a (49) must match the size of tensor b (16) at non-singleton dimension 1 (dimensiones de tensor / shape no coincidentes)
Solución: este tipo de error indica que la arquitectura del modelo no coincide con el cargador; el archivo no está dañado. Hay tres situaciones comunes: usar el cargador genérico de checkpoints para cargar un modelo que solo contiene parte de los pesos, en cuyo caso debes usar el nodo de carga específico correspondiente (la tabla de nodos loader correspondientes a cada tipo de modelo está en Dónde colocar los modelos); que la LoRA y el modelo base tengan arquitecturas distintas, en cuyo caso cambia a una LoRA de la misma arquitectura; o que el modelo sea demasiado nuevo y la versión actual de ComfyUI aún no admita su arquitectura, así que actualiza a la última versión y vuelve a intentarlo. Una VAE mal asignada también provoca errores de número de canales no coincidente; por ejemplo, si un modelo Flux usa sdxl_vae.safetensors, basta con cambiarlo por el ae.safetensors de la publicación oficial de Flux. Ve primero a la página de publicación del modelo para confirmar la arquitectura indicada y luego elige el cargador que coincida.
Cuándo escalar el problema
Si se produce cualquiera de las siguientes situaciones, deja de pelear en local y abre un issue en el repositorio de GitHub de ComfyUI
- Tras cambiar al cargador y directorio correctos, sigue apareciendo el error de dimensiones de tensor.
- El mismo archivo de modelo se carga con normalidad en otras herramientas, y solo ComfyUI da error.
- Tras volver a descargarlo, el problema persiste; se sospecha que el propio archivo del modelo tiene un fallo.
Al abrir el issue, adjunta: el texto completo del error, el nombre del modelo y la fuente de descarga, y tu versión de ComfyUI y la forma de iniciarlo.