Si alguna vez has construido un flujo de trabajo de IA en ComfyUI y de repente un nodo se pone rojo, mostrando una serie de mensajes de error en inglés al hacer clic en él, este artículo fue escrito para ti.
1. ¿Por qué aparecen los errores rojos?
El sistema de nodos de ComfyUI se ejecuta sobre scripts de Python. Cuando los parámetros de entrada de un nodo no cumplen los requisitos o falta una biblioteca de dependencias, el nodo se muestra con fondo rojo y detiene su ejecución. Esto suele ocurrir en los siguientes escenarios:
Caso 1: Ruta incorrecta del archivo de pesos del modelo (el más frecuente)
Cuando descargas un archivo JSON de flujo de trabajo de otra persona y lo importas en tu propio ComfyUI, si el archivo de modelo que esa persona utiliza no existe en tu sistema o se encuentra en una ruta diferente, el nodo Load Checkpoint mostrará un error rojo. La solución es revisar la información de error específica en el panel de la cola del lado derecho, que generalmente indica con precisión qué archivo falta. Descarga el archivo .safetensors correspondiente desde HuggingFace o Civitai y colócalo en el directorio models/checkpoints.
Caso 2: Plugin de nodo personalizado no instalado
El flujo de trabajo de otra persona utiliza complementos de terceros como ComfyUI-Impact-Pack o ComfyUI-Manager, que no tienes instalados localmente. En este caso, el mensaje de error incluirá el texto "ModuleNotFoundError". Pasos para resolver: abre ComfyUI Manager (haz clic en el botón Manager en la barra de herramientas superior) → busca el nombre del nodo que falta → haz clic en Instalar.
Caso 3: Tipo de entrada incompatible
Por ejemplo, un nodo requiere una entrada de tipo IMAGE, pero conectaste datos de tipo LATENT. ComfyUI no convierte automáticamente los tipos de datos, por lo que generará un error. La solución es agregar un nodo de conversión de tipo entre ambos nodos: para convertir de LATENT a IMAGE utiliza el nodo VAE Decode, y para el caso inverso usa el nodo VAE Encode.
2. Lista de errores frecuentes y métodos de corrección
"No module named 'xxx'"
Falta una biblioteca de dependencias de Python. Abre la línea de comandos en el directorio raíz de ComfyUI y ejecuta pip install xxx para instalar el paquete faltante. Si no estás seguro del nombre exacto, copia primero el nombre completo del módulo que aparece en el mensaje de error.
"CUDA out of memory"
Memoria de GPU insuficiente. Soluciones: reduce la resolución (por ejemplo, de 1024x1024 a 512x512); agrega el parámetro --lowvram en los argumentos de inicio de ComfyUI; o cierra otros programas que consuman recursos de GPU.
"Checkpoint file not found"
El archivo del modelo falta o la ruta está configurada incorrectamente. Verifica que el archivo mencionado en el error exista en el directorio models/checkpoints y asegúrate de que las mayúsculas y minúsculas coincidan exactamente.
"Invalid image size: must be multiple of 64"
La resolución no es un múltiplo de 64. Ajusta el ancho y alto a dimensiones estándar como 800x1200 o 512x768.
3. Mejores prácticas para prevenir errores
Antes de importar el flujo de trabajo de otra persona, haz una copia de seguridad de tu proyecto actual (File → Save Workflow); segundo, siempre reinicia el servicio de ComfyUI después de instalar un nuevo plugin de nodos; tercero, actualiza regularmente el programa principal de ComfyUI y todos los nodos personalizados a su última versión — muchos errores se producen porque los plugins antiguos son incompatibles con la nueva versión del programa principal.
