Skip to content

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 nodes y 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 .bat de 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

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.