Skip to content

Resumen de diagnóstico de errores: si algo falla, mira primero esta página (verificación rápida en 60 segundos) ​

Cuando ComfyUI da un error, no te apresures a buscar el texto del error. La mayoría de los errores de ComfyUI se pueden clasificar en menos de 60 segundos en cuatro categorías: entorno e inicio, carga de modelos, memoria de vídeo y generación, y nodos personalizados. Esta página te ayuda a hacer primero una revisión rápida, localizar el problema en una categoría y luego saltar a la página específica correspondiente para tratarlo en profundidad.

Qué podrás hacer al terminar ​

  • Confirmar en 60 segundos con 3 comandos si la GPU, CUDA y el entorno de Python funcionan correctamente
  • Clasificar los errores en «entorno / modelo / memoria de vídeo / nodos», sin búsquedas a ciegas
  • Comparar con los textos de errores frecuentes y aplicar directamente soluciones ya verificadas
  • Saber qué información recopilar y dónde preguntar cuando no puedes resolverlo por tu cuenta

Primera revisión: verificación rápida en 60 segundos ​

Lo primero que hay que hacer cuando surge un problema: vuelve a la ventana del terminal donde iniciaste ComfyUI y lee el registro. Cuando falla la generación, la interfaz muestra el cuadro de diálogo «Prompt execution failed»; haz clic en «Show report» para ver la información detallada del error: cópiala primero.

Luego ejecuta estos tres comandos en el terminal para revisar el entorno:

bash
# 1. 确认 GPU 能被系统识别(NVIDIA 显卡)
nvidia-smi

# 2. 确认 PyTorch 的 CUDA 可用
python -c "import torch; print('CUDA available:', torch.cuda.is_available())"

# 3. 确认 Python 版本(需 3.9+,推荐 3.12)
python --version

Deberías ver: el comando 1 muestra el modelo de la tarjeta gráfica y la versión del controlador; el comando 2 muestra CUDA available: True; el comando 3 muestra un número de versión 3.9 o superior. Si alguno no cumple lo esperado, salta primero a Qué hacer si no se instala: diagnóstico de instalación e inicio.

💡 Descarta primero los nodos personalizados

De los issues de feedback que recibe el equipo oficial, la mayoría están relacionados con nodos personalizados. Antes de investigar en profundidad, desactiva primero todos los nodos personalizados siguiendo el método de Diagnóstico de nodos personalizados: desactivar primero y luego búsqueda binaria para confirmar si el problema lo causan los nodos.

Diagnóstico de problemas frecuentes ​

Errores de ComfyUI relacionados con el entorno y el inicio ​

"Torch not compiled with CUDA enabled" ​

Causa: el PyTorch instalado es la versión para CPU, sin soporte CUDA compilado, por lo que la GPU no puede participar en el cálculo.

Solución:

  1. Desinstala primero el torch existente:
bash
pip uninstall torch
  1. Reinstala PyTorch con CUDA (CUDA 13.0):
bash
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130
  1. Verifica la instalación:
bash
python -c "import torch; print(torch.cuda.is_available())"

Deberías ver: la salida True.

"Frontend or Templates Package Not Updated" ​

Causa: tras actualizar ComfyUI mediante Git, las dependencias del frontend no se actualizaron al mismo tiempo.

Solución:

bash
pip install -r requirements.txt

Deberías ver: cuando termine la instalación de las dependencias, reinicia ComfyUI y el aviso desaparecerá.

Problemas relacionados con la carga de modelos ​

"Value not in list: ckpt_name: 'model-name.safetensors' not in []" ​

Causa: el archivo del modelo al que hace referencia el flujo de trabajo no existe, o no se descargó, o se colocó en el subdirectorio equivocado. La lista vacía en not in [] indica que ComfyUI no encontró ningún modelo en el directorio correspondiente.

Solución:

  1. Comprueba que el modelo esté en el subdirectorio correcto:
    • Checkpoints: models/checkpoints/
    • VAE: models/vae/
    • LoRA: models/loras/
    • ControlNet: models/controlnet/
  2. Si falta el modelo, usa ComfyUI Manager para descargarlo automáticamente, o descárgalo manualmente y colócalo en el directorio correspondiente.
  3. Si el modelo está en otra ubicación (por ejemplo, compartido con otro software de dibujo), edita extra_model_paths.yaml para añadir un directorio de modelos personalizado; consulta Instalación del paquete portátil de Windows.

Deberías ver: tras reiniciar ComfyUI, el modelo aparece en el menú desplegable del nodo.

"Error while deserializing header" ​

Causa: el archivo del modelo se dañó durante la descarga, o no se puede leer por falta de espacio en disco o por permisos de archivo incorrectos.

Solución:

  1. Vuelve a descargar el modelo (el archivo puede pesar más de 2–15 GB; asegúrate de que la descarga esté completa).
  2. Comprueba que el espacio libre en disco sea suficiente.
  3. Comprueba que el proceso de ComfyUI tenga permiso de lectura sobre el archivo del modelo.
  4. Prueba con otro modelo para confirmar si el problema es de un solo archivo o es sistémico.

Errores de ComfyUI relacionados con la memoria de vídeo y la generación ​

"RuntimeError: CUDA out of memory" ​

Causa: no hay memoria de vídeo suficiente para el modelo y el flujo de trabajo actuales; es frecuente con modelos grandes o generaciones de alta resolución.

Solución: reduce gradualmente el uso de memoria de vídeo en orden, reiniciando ComfyUI después de cada cambio:

bash
# 方案 1:先用 lowvram(文本编码器放到 CPU)
python main.py --lowvram

# 方案 2:不够再换 novram
python main.py --novram

# 方案 3:最后手段,纯 CPU(很慢,仅绝对必要时使用)
python main.py --cpu

También puedes reducir la resolución de generación o el tamaño del lote, y cerrar otros programas que ocupen memoria de vídeo. Para más soluciones sistémicas, consulta Memoria de vídeo insuficiente y bloqueos: soluciones sistémicas para OOM.

Deberías ver: la generación se completa sin interrupciones ni errores.

"El resultado generado es completamente negro o de color plano" ​

Causa: hay un problema en la etapa de salida. Las causas documentadas incluyen: anomalía en la etapa del VAE (el flujo de texto a imagen predeterminado es KSampler → VAE Decode → Save Image; un VAE mal cargado afecta directamente a la salida); el parámetro de inicio --fp16-vae ejecuta el VAE en fp16, lo que puede provocar imágenes negras; en modelos cuantizados, el backend de atención puede devolver silenciosamente una salida negra.

Solución:

  1. Revisa el flujo de trabajo: confirma que después del KSampler va VAE Decode, y que el VAE cargado coincide con la arquitectura del modelo (por ejemplo, Flux debe usar ae.safetensors, no sdxl_vae ni taesd).
  2. Si añadiste --fp16-vae al iniciar, quita ese parámetro y reinicia.
  3. Si activaste FlashAttention (--use-flash-attention o habilitado por un paquete de nodos), cambia al backend de atención predeterminado, reinicia y vuelve a intentarlo; se ha verificado que deshabilitar FlashAttention en modelos cuantizados resuelve la salida totalmente negra.
  4. Desactiva la vista previa en tiempo real para descartar interferencias: en algunos casos solo la vista previa está negra y el archivo guardado en realidad es normal.

Deberías ver: tras volver a generar, la imagen de salida es normal.

Problemas relacionados con nodos personalizados ​

"Can't Find Custom Node" (no se encuentra el nodo personalizado) ​

Causa: el nodo personalizado usado por el flujo de trabajo no está instalado o no está habilitado correctamente, y la validación del frontend reporta un error.

Solución:

  1. Primero deshabilita temporalmente la validación de nodos en los ajustes de ComfyUI para delimitar el problema.
  2. Instala el paquete de nodos indicado según el aviso y reinicia.
  3. Si el problema persiste, sigue el flujo de Resolución de problemas de nodos personalizados: deshabilitar primero y luego bisección para deshabilitar todos los nodos y localizar el culpable por bisección.

"Missing nodes still showing as missing after installation and restart" ​

Causa: el paquete de nodos se instaló pero la importación de dependencias falló; en la consola/logs es común ver «Failed to import». Causas típicas: el paquete de nodos necesita dependencias wheel adicionales; distintos plugins tienen requisitos de versión de dependencias en conflicto (por ejemplo, uno pide torch==2.4.1 y otro torch>=2.4.2); problemas de red impidieron instalar las dependencias.

Solución:

  1. Abre el registro de la terminal y localiza el nombre del paquete de nodos correspondiente al «Failed to import».
  2. Instala manualmente las dependencias que faltan de ese paquete de nodos.
  3. Ante conflictos de versión de dependencias, consulta los métodos de gestión del entorno Python de la página de resolución de problemas de nodos personalizados.

¿Sigue sin funcionar? ​

Reúne esta información antes de preguntar; puede mejorar mucho la eficiencia de la resolución:

bash
# GPU 型号与驱动版本
nvidia-smi --query-gpu=driver_version --format=csv

# CUDA 是否可用及版本
python -c "import torch; print('CUDA available:', torch.cuda.is_available()); print('CUDA version:', torch.version.cuda)"

# Python 版本
python --version

Al preguntar, adjunta: el texto completo del error (registro de la terminal o contenido de «Show report»), el modelo de GPU, la versión de ComfyUI, el método de instalación (versión de escritorio / portable / instalación manual) y si usas nodos personalizados.

Dónde preguntar:

Avance de la próxima lección ​

Esta página te ayuda a clasificar los errores de ComfyUI en cuatro grandes categorías. La próxima lección profundiza en la más frecuente: Resolución de problemas de nodos personalizados: deshabilitar primero y luego bisección, que te enseña a usar el método de bisección para localizar rápidamente el nodo causante.

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.