Quando o ComfyUI para de funcionar, quase sempre existe uma mensagem exata explicando o motivo, e ela não está na interface do navegador. Está no terminal que abriu junto com o programa. Esse é o ponto de partida de todo diagnóstico sério.
Resposta direta: o ComfyUI falha principalmente por quatro motivos. Custom nodes incompatíveis que quebram a inicialização, modelos colocados na pasta errada ou incompletos, memória de vídeo insuficiente para o workflow carregado, e dependências de Python desatualizadas depois de uma atualização. Leia o terminal antes de mexer em qualquer outra coisa.
Por que a interface engana e o terminal não
O ComfyUI é dois programas ao mesmo tempo. Existe um servidor em Python que faz o trabalho pesado, e existe uma página web que só desenha o grafo de nós. Quando algo quebra no servidor, a página continua bonita e responsiva, mostrando no máximo um aviso genérico. É por isso que tanta gente descreve o problema como “não acontece nada quando clico em gerar”. Não acontece nada na tela porque o erro aconteceu do outro lado.
A primeira regra do diagnóstico é simples: deixe a janela do terminal visível ao lado do navegador. Clique em gerar e observe as duas ao mesmo tempo. Se o terminal cospe várias linhas e para, você tem uma exceção de Python. Se o terminal não escreve nada, o pedido nem chegou ao servidor, e o problema é de conexão entre navegador e servidor local. Essas duas situações exigem correções completamente diferentes, e confundir as duas é o motivo pelo qual pessoas reinstalam tudo sem necessidade.
Vale a pena entender essa arquitetura antes de qualquer coisa. Se você ainda está montando seu ambiente do zero, o caminho mais curto é seguir um passo a passo estruturado como o nosso tutorial de ComfyUI em português e só depois voltar aqui para resolver problemas específicos.
O ComfyUI nem abre: falha na inicialização
Falha de inicialização significa que o servidor morre antes de imprimir o endereço local de acesso. O sintoma clássico é a janela preta que aparece, roda algumas linhas e fecha sozinha. Se ela fecha rápido demais para ler, abra o terminal manualmente na pasta do ComfyUI e rode o script de inicialização de lá. Assim a janela permanece aberta e você consegue ler a mensagem final, que é a única que importa.
Erro de importação de módulo
Se a última linha fala em importação de módulo que não existe, alguma biblioteca de Python sumiu ou nunca foi instalada corretamente. Isso acontece bastante depois de atualizar, porque uma versão nova pode exigir pacotes que a instalação antiga não tinha. A correção é reinstalar as dependências dentro do mesmo ambiente virtual que o ComfyUI usa. O erro mais comum aqui não é técnico, é humano: as pessoas instalam pacotes no Python global do sistema enquanto o ComfyUI roda em um ambiente isolado, e nada muda. Confirme sempre que o ambiente virtual está ativo antes de instalar qualquer coisa.
Erro logo depois de mencionar um custom node
Se as últimas linhas antes da falha mencionam o nome de uma extensão, você achou o culpado. Custom nodes são código de terceiros carregado na inicialização, e um único node quebrado derruba o programa inteiro. A verificação leva menos de um minuto: renomeie temporariamente a pasta de custom nodes para outro nome e tente iniciar de novo. Se o ComfyUI sobe limpo, o problema está lá dentro. Depois é só devolver o nome original e mover as extensões de volta em pequenos grupos até o erro voltar a aparecer.
Conflito de porta
Se a mensagem fala em endereço já em uso, existe outra instância do ComfyUI rodando em segundo plano, ou algum outro programa ocupou a mesma porta. Feche todos os processos de Python pendentes e tente novamente. Em máquinas Windows é comum uma instância anterior continuar viva depois de fechar a janela no X, sem encerrar o processo.
Nós vermelhos: o que a borda vermelha realmente diz
Um nó vermelho no ComfyUI não significa que o nó está quebrado. Significa que o servidor não conseguiu executar aquele ponto específico do grafo. A distinção importa porque muita gente apaga o nó e coloca outro igual, o que não resolve nada. O erro real aparece em uma caixa de texto quando você passa o mouse ou abre o painel de erro, e ele costuma cair em três categorias.
A primeira é entrada faltando. Uma conexão foi desfeita sem você perceber, geralmente ao arrastar nós pela tela. Olhe se todos os pontos de entrada do nó vermelho têm um fio chegando. A segunda é incompatibilidade de tipo. Você ligou uma saída de modelo em uma entrada que espera condicionamento, por exemplo. O ComfyUI normalmente impede isso na hora de arrastar, mas workflows importados de outras versões conseguem carregar ligações inválidas. A terceira é o nó que não existe mais, mostrado com o título em vermelho e sem corpo. Isso quer dizer que o workflow depende de uma extensão que você não tem instalada.
Para esse último caso, a solução honesta é descobrir de qual pacote o nó vem. O nome do nó normalmente é único o suficiente para uma busca resolver. Instale o pacote, reinicie o servidor por completo e recarregue a página. Reiniciar só o navegador não adianta, porque o registro de nós é montado quando o servidor sobe.
Modelos que não aparecem na lista
Este é o problema mais fácil de resolver e o mais frequente. Se o seletor de checkpoint aparece vazio ou não mostra o arquivo que você acabou de baixar, verifique três coisas nesta ordem.
Primeiro, a pasta. Cada tipo de arquivo tem seu lugar dentro da estrutura de modelos, e checkpoints, LoRAs, VAEs e upscalers não são intercambiáveis. Um LoRA jogado na pasta de checkpoints simplesmente não aparece em lugar nenhum. Segundo, o download completo. Arquivos de modelo são grandes e uma conexão instável entrega arquivos truncados que existem no disco mas não abrem. Se o tamanho parece menor do que o anunciado na origem, baixe de novo. Terceiro, o momento. O ComfyUI monta a lista de modelos ao iniciar. Se você copiou o arquivo com o programa já aberto, ele não vai aparecer até você atualizar a lista ou reiniciar o servidor.
Vale lembrar que arquivos baixados de repositórios comunitários às vezes vêm com formato ou versão base diferente do que você espera, o que gera erro no momento de carregar e não no momento de listar. Se você baixa modelos com frequência, nosso guia do Civitai em português explica como ler a ficha técnica antes de baixar e evitar esse retrabalho.
VRAM insuficiente e travamento no meio da geração
Se a geração começa, a barra de progresso anda um pouco e tudo morre, você provavelmente esgotou a memória da placa de vídeo. O erro no terminal costuma mencionar memória de forma explícita, mas nem sempre: em alguns casos o processo é encerrado pelo sistema operacional sem mensagem nenhuma, o que confunde bastante.
A ordem de ataque aqui é do mais barato para o mais caro. Comece fechando o que consome vídeo em paralelo, principalmente navegadores com muitas abas, players de vídeo e programas de chamada. Depois reduza a resolução de saída, porque o consumo cresce muito mais rápido que a área da imagem. Em seguida corte o batch para uma imagem por vez. Só então mexa nos modos de economia de memória que o ComfyUI oferece na inicialização, que trocam velocidade por espaço movendo partes do modelo entre a placa e a memória do sistema.
Existe também um caso específico e traiçoeiro: o segundo estágio. Muitos workflows fazem a imagem base e depois aplicam upscale ou refino. O primeiro estágio passa tranquilo, o segundo estoura, e a pessoa jura que o problema é aleatório. Não é. Desligue o estágio final e teste. Se passa, o gargalo está lá.
Se sua placa é de entrada, ajustar expectativas ajuda mais que qualquer configuração. Nossa análise de desempenho com RTX 3060 rodando Stable Diffusion no Brasil mostra o que é realista esperar em cada faixa de resolução, e onde compensa parar de insistir.
Quando o hardware local simplesmente não dá conta, alugar GPU por hora costuma ser mais racional do que trocar de placa. O caminho está descrito no nosso tutorial de RunPod em português, que cobre o mesmo ComfyUI rodando em máquina remota.
Workflows que quebram depois de atualizar
Atualizar o ComfyUI e ver todos os workflows salvos falharem é uma experiência universal. O motivo é estrutural: um workflow é um arquivo que guarda nomes de nós e nomes de parâmetros. Quando uma versão nova renomeia um parâmetro ou reorganiza um nó, o arquivo antigo aponta para algo que mudou de lugar.
A regra prática que economiza horas é nunca atualizar o ComfyUI e os custom nodes ao mesmo tempo. Atualize um, confirme que tudo abre, e só depois atualize o outro. Assim, quando algo quebra, você sabe exatamente o que causou. E antes de qualquer atualização, faça uma cópia da pasta de workflows. É o único backup que realmente importa, porque modelos você baixa de novo e workflow bem ajustado você não recupera.
Se um workflow específico quebrou e você não quer investigar, existe um atalho: reconstrua a espinha dorsal com nós nativos e importe só as partes que dependem de extensões. Workflows nativos quase nunca quebram entre versões, porque os nós padrão mantêm compatibilidade. Quem monta cadeias longas com LoRAs vai reconhecer esse padrão, e o nosso guia de treinamento de LoRA em português mostra como manter esse tipo de cadeia organizada desde o começo.
Custom nodes: a causa número um de quase tudo
Se existisse uma única estatística útil sobre problemas no ComfyUI, seria esta: a maioria das falhas vem de extensões, não do programa. Custom nodes são incríveis e são também código que ninguém testou na sua combinação exata de sistema, versão de Python e placa de vídeo.
Adote uma disciplina simples. Instale uma extensão por vez e reinicie depois de cada uma. Se algo quebrar, você sabe qual foi. Remova o que você não usa, porque cada extensão instalada é código executado na inicialização mesmo que você nunca coloque aquele nó no grafo. E desconfie de qualquer pacote que exija instalar bibliotecas com versões travadas: isso costuma entrar em conflito com o que outra extensão pediu, e o resultado é um ambiente que funciona hoje e quebra na próxima atualização de qualquer coisa.
Uma observação sobre gerenciadores de extensões. Eles ajudam bastante a instalar e atualizar, mas também escondem o que está acontecendo. Quando o diagnóstico fica difícil, olhe a pasta diretamente. A lista de subpastas é a verdade, o painel bonito é só uma representação dela.
Quando o problema é o prompt, não o programa
Nem toda falha é técnica. Existe uma categoria de reclamação que soa como bug e não é: a imagem sai preta, borrada ou completamente diferente do pedido. Imagem preta com modelos específicos normalmente indica incompatibilidade de VAE ou de precisão numérica, e o teste é trocar o VAE por outro conhecido. Imagem borrada ou sem forma indica número de passos baixo demais ou escala de orientação em valor extremo. Imagem que ignora o prompt indica que o texto está entrando no nó errado, o que acontece com frequência em workflows com prompt positivo e negativo separados.
Antes de culpar a instalação, teste com um prompt simples e um modelo popular. Se a imagem sai correta, sua instalação está boa e o ajuste é de conteúdo. Nesse ponto, uma biblioteca de referências ajuda mais que qualquer configuração, e você encontra bastante material pronto na nossa coletânea de prompts NSFW em português.
Tabela de sintomas e correções
| Sintoma | Causa provável | Correção |
|---|---|---|
| Janela do terminal fecha sozinha | Exceção na inicialização | Rodar o script pelo terminal aberto e ler a última linha |
| Página abre mas o botão gerar não faz nada | Servidor caiu ou perdeu conexão | Reiniciar o servidor e recarregar a página |
| Nó com título vermelho e sem corpo | Extensão ausente | Instalar o pacote do nó e reiniciar o servidor |
| Seletor de checkpoint vazio | Arquivo na pasta errada ou lista não atualizada | Conferir a pasta correta e atualizar a lista |
| Progresso trava e o processo morre | Memória de vídeo esgotada | Baixar resolução, reduzir batch, fechar apps que usam GPU |
| Workflow antigo falha depois de atualizar | Parâmetro renomeado entre versões | Recriar o trecho afetado com nós nativos |
| Imagem sai completamente preta | VAE incompatível ou precisão numérica | Trocar o VAE e testar com modelo conhecido |
| Falha só no fim da geração | Estágio de upscale ou refino pesado | Desligar o estágio final e testar isolado |
Checklist de diagnóstico, do mais rápido ao mais lento
- Leia a última linha do terminal. Ela resolve ou direciona a maioria dos casos em segundos.
- Recarregue a página do navegador com cache limpo, para descartar interface travada.
- Reinicie o servidor por completo, encerrando processos de Python pendentes.
- Teste um workflow mínimo, apenas carregar modelo, prompt e sampler, sem extensões.
- Confirme se o arquivo de modelo está na pasta certa e tem o tamanho esperado.
- Baixe a resolução e o batch para o mínimo e tente gerar de novo.
- Renomeie a pasta de custom nodes e inicie limpo para isolar extensões.
- Devolva as extensões em grupos pequenos até o erro reaparecer.
- Reinstale as dependências dentro do ambiente virtual correto.
- Atualize o driver da placa de vídeo, que é lento e raramente é a causa, mas elimina a dúvida.
- Só então considere instalação limpa em pasta nova, mantendo modelos e workflows de fora.
Quando parar de insistir no local
Existe um ponto em que consertar deixa de compensar. Se você passou mais tempo depurando do que gerando nas últimas semanas, e se a máquina está no limite mesmo quando tudo funciona, o problema não é bug, é dimensionamento. Nesse cenário há dois caminhos honestos.
O primeiro é mover a mesma stack para uma GPU alugada e manter o controle total sobre modelos e workflows. Você continua com o ComfyUI, só que em hardware adequado, e paga pelo tempo de uso em vez de comprar equipamento.
O segundo é aceitar que, para muita gente, o objetivo nunca foi manter uma instalação de Python funcionando, e sim gerar imagens. Se esse é o seu caso, uma plataforma pronta como o AI Nudez entrega o resultado sem nó vermelho, sem ambiente virtual e sem depuração. Não substitui o controle fino do ComfyUI, mas resolve o dia a dia enquanto você conserta a instalação com calma.
Muita gente acaba usando os dois em paralelo, o local para experimentos e ajustes profundos, e uma ferramenta online para volume e prazo. Se você quer comparar as opções antes de decidir, vale olhar a nossa lista das melhores IAs sem censura e ver onde cada uma se encaixa.
Prevenção: o que evita a maioria dos problemas
Depois de resolver, vale blindar. Guarde uma cópia da pasta de workflows fora da pasta do programa. Mantenha uma lista escrita das extensões que você realmente usa, porque na hora de reinstalar essa lista vale ouro. Não atualize nada em dia de entrega. E, sempre que instalar algo novo, gere uma imagem de teste antes de mexer em qualquer outra coisa, para que o intervalo entre “funcionava” e “quebrou” seja o menor possível.
Essa última prática é a mais subestimada. Depuração é basicamente reduzir o espaço de busca, e quem instala cinco coisas de uma vez transforma um problema de trinta segundos em uma tarde perdida. Se você mantiver essa disciplina, o ComfyUI passa a ser previsível, e quando algo quebrar você vai saber onde olhar antes mesmo de abrir o terminal. Para quem prefere um ambiente com menos peças móveis, uma alternativa como o AI Nudez também funciona bem como plano B durante uma reinstalação demorada.
Se o seu objetivo final é publicar ou monetizar o que você gera, a estabilidade do ambiente deixa de ser detalhe e vira requisito de trabalho. Nesse caso o assunto muda de figura, e o nosso material sobre como ganhar dinheiro com IA NSFW trata da parte operacional que vem depois de a geração funcionar.
Perguntas frequentes
Por que o ComfyUI abre a página mas não gera nada?
Na maioria das vezes o servidor em Python caiu ou perdeu a conexão com o navegador, enquanto a página continua carregada em memória. Olhe o terminal: se ele não registra nada quando você clica em gerar, o pedido não chegou. Reinicie o servidor e recarregue a página com cache limpo.
O que significa um nó vermelho no ComfyUI?
Significa que a execução parou naquele ponto do grafo, não que o nó esteja defeituoso. As causas mais comuns são entrada desconectada, tipo incompatível entre saída e entrada, ou um nó que pertence a uma extensão que você não tem instalada. A mensagem de erro do nó indica qual dos três é o caso.
Por que meu modelo não aparece na lista de checkpoints?
Ou o arquivo está na subpasta errada dentro da estrutura de modelos, ou o download veio incompleto, ou você copiou o arquivo com o programa já aberto e a lista não foi atualizada. Confira o tamanho do arquivo, confirme a pasta e reinicie o servidor.
Como saber se o erro é falta de VRAM?
O padrão é a geração começar e morrer no meio, muitas vezes sempre no mesmo estágio. Reduza a resolução e o batch para o mínimo e teste. Se passar, era memória. Se o processo é encerrado sem mensagem nenhuma, também suspeite de memória, porque o sistema operacional às vezes mata o processo sem aviso.
Atualizei o ComfyUI e todos os meus workflows quebraram. Tem conserto?
Sim, na maioria dos casos. Workflows guardam nomes de nós e parâmetros, e uma versão nova pode ter renomeado algo. Recrie o trecho afetado com nós nativos, que mantêm compatibilidade melhor, e reimporte apenas as partes que dependem de extensões. Manter cópia da pasta de workflows evita esse susto.
Custom nodes podem impedir o ComfyUI de iniciar?
Podem, e é a causa mais frequente de falha na inicialização. Como as extensões são carregadas quando o servidor sobe, uma única incompatível derruba tudo. Renomeie a pasta de custom nodes e tente iniciar. Se subir limpo, devolva as extensões em grupos pequenos até identificar a responsável.
Vale a pena reinstalar o ComfyUI do zero?
Só depois de esgotar o isolamento de extensões e a reinstalação de dependências. Reinstalar é lento e apaga o histórico do problema, então você aprende nada e pode repetir o erro. Se for reinstalar, faça em pasta nova e mantenha modelos e workflows fora dela.
Existe alternativa se eu não conseguir fazer o ComfyUI rodar?
Existem duas. Rodar a mesma stack em uma GPU alugada por hora, o que resolve limitações de hardware sem mudar seu fluxo de trabalho, ou usar uma plataforma online pronta, que elimina a manutenção do ambiente em troca de menos controle sobre modelos e parâmetros. A escolha depende de quanto controle fino você realmente precisa.
