Diagnóstico de nodos personalizados: desactivar primero y luego bisección
¿Errores al arrancar, nodos en rojo, cuelgues justo después de instalar nodos nuevos? No te apresures a reinstalar ComfyUI: la mayoría de los errores de nodos personalizados de ComfyUI se localizan en diez minutos: desactiva primero todos los nodos para confirmar el alcance y luego usa la bisección para identificar cuál es.
Síntomas
Si aparece cualquiera de estas situaciones, sospecha primero de los nodos personalizados:
- Al arrancar, la consola se llena de errores rojos de importación fallida en cadena (
Failed to import,Cannot import … module for custom nodesy similares), y faltan nodos en el menú de nodos. - Tras cargar un flujo de trabajo, algunos nodos aparecen en rojo en el lienzo.
- Acabas de instalar un paquete de nodos nuevo y ComfyUI se queda atascado en la pantalla de arranque o se bloquea directamente.
Primera reacción:
En el registro de arranque aparece un error tipo Failed to import
Inicia primero una vez con --disable-all-custom-nodes para separar el "problema de nodos" del "problema del propio ComfyUI".
Un nodo aparece en rojo en el lienzo
Confirma que el paquete de nodos está instalado y activado; si sigue en rojo tras refrescar, significa que la importación de ese paquete falló; busca la causa en el registro de arranque.
Tras instalar nodos nuevos, el arranque se queda colgado o se bloquea
Desactiva primero todos los nodos para recuperar el arranque y luego usa la bisección para encontrar el nodo problemático.
Comprobación rápida (60 segundos)
- ¿Has instalado o actualizado algún paquete de nodos recientemente? Primero revierte la versión o desinstálalo.
- ¿Usas la versión portable (Portable)? Para el diagnóstico tienes que editar el
.batde arranque y añadir parámetros. - Algunos nodos descargan modelos por internet en el primer arranque; comprueba primero la red y el proxy.
- Las dependencias deben instalarse en el entorno Python que ComfyUI usa realmente, no en el Python del sistema.
Diagnóstico en tres pasos
Paso 1: arrancar con todos los nodos personalizados desactivados
Versión portable: abre con el Bloc de notas el .bat de arranque que sueles ejecutar con doble clic (con GPU NVIDIA es run_nvidia_gpu.bat, con AMD run_amd_gpu.bat, con CPU run_cpu.bat), añade --disable-all-custom-nodes al final del comando de arranque, guarda y reinicia.
Instalación desde código fuente o con venv: añade el mismo parámetro después del comando de arranque.
Si arranca con normalidad, el problema está en los nodos: pasa al paso 2; si sigue dando errores, el problema está en el propio ComfyUI o en el entorno: vuelve primero al resumen de diagnóstico.
Paso 2: localizar el nodo problemático por bisección
Divide los paquetes de nodos del directorio custom_nodes en dos mitades iguales, saca temporalmente una mitad del directorio (córtala y guárdala en otro lugar como copia de seguridad) y arranca para probar solo con la otra mitad:
- Da error: el problema está en la mitad que quedó; sigue dividiendo a la mitad.
- Normal: el problema está en la mitad que sacaste; devuélvela y sigue dividiendo a la mitad.
Repitiendo dos o tres rondas se puede localizar un único paquete de nodos: con 10 paquetes bastan 4 rondas como máximo, mucho más rápido que probar uno por uno.
Paso 3: reparar o sustituir el nodo problemático
- Actualiza primero a la última versión: la mayoría de los errores se deben a que el nodo no se ha adaptado a la interfaz de la nueva versión de ComfyUI.
- Instala las dependencias que falten según el README: entra en el directorio del nodo y ejecuta
pip install -r requirements.txt@@I18N_KEEP_000022@@ con el Python donde está ComfyUI. - Si sigue fallando: abre un issue en el repositorio del nodo adjuntando el registro de arranque completo, o elimínalo y sustitúyelo por un nodo alternativo con la misma función.
Cuándo escalar
- Sigue sin arrancar tras desactivar todos los nodos: no es un problema de nodos; pasa a fallo al cargar el modelo.
- El error del registro apunta a torch, CUDA o la memoria de vídeo en lugar de a un import: es un problema de entorno; no pierdas tiempo con los nodos.
- Sigue dando errores tras actualizar o reinstalar dependencias: pide ayuda en la sección de issues del repositorio del nodo, adjuntando el registro completo y el número de versión de ComfyUI.
Lecturas relacionadas: Resumen de diagnóstico · Fallo al cargar el modelo · Biblioteca de plantillas: carga de flujos de trabajo oficiales con un clic