Pular para o conteúdo
QGIS
Solução de problemas

[Resolvido] DLL load failed importing _C no QGIS

Publicado em Atualizado em

ImportError: DLL load failed while importing _C significa que o Windows encontrou o PyTorch e depois se recusou a carregar uma das DLLs compiladas abaixo dele. Você encontra esse erro no QGIS depois que um plugin instala torch no Python do QGIS, inclusive o nosso. Instale o Microsoft Visual C++ Redistributable (x64) e reinicie o Windows. Isso resolve na maioria das máquinas.

Traceback (most recent call last):
  File "C:\...\site-packages\torch\__init__.py", line 141, in <module>
    raise err
OSError: [WinError 126] The specified module could not be found.
Error loading "C:\...\site-packages\torch\lib\fbgemm.dll" or one of its dependencies.

ImportError: DLL load failed while importing _C: The specified module could not be found.

O mesmo erro nomeia um arquivo diferente em algumas máquinas, e as correções abaixo são as mesmas:

Error loading "C:\...\site-packages\torch\lib\shm.dll" or one of its dependencies.

Aplica-se ao Windows 10 e 11, ao QGIS 3.22 e posteriores, e ao PyTorch 2.4.0 até 2.8.0, as versões para Windows que incluem fbgemm.dll. A versão 2.9.0 deixou de incluir esse arquivo.

Se o seu erro disser [WinError 127] em vez de 126, pare aqui. Isso significa que a DLL foi carregada e que está faltando um símbolo dentro dela. É uma incompatibilidade de versão entre pacotes, não este bug.

A correção rápida

  1. Instale o Visual C++ Redistributable (x64)

    Execute vc_redist.x64.exe em aka.ms/vc14/vc_redist.x64.exe. Escolha x64 mesmo que você já tenha x86. São pacotes separados, e o torch precisa de x64.

  2. Reinicie o Windows

    Reinicie o Windows, não apenas o QGIS. O instalador deixa parte do trabalho para a reinicialização.

  3. Procure um segundo Python

    Em um Prompt de Comando, execute where python. Mais de um resultado significa que um Python do Anaconda, Miniconda ou independente está competindo com o Python do QGIS.

  4. Tire esse Python do PATH

    Vá para Iniciar, procure por "variáveis de ambiente", abra Editar as variáveis de ambiente do sistema, Variáveis de Ambiente, Path. Exclua as entradas do Python que você não usa no QGIS, depois saia do Windows e entre novamente.

Se o erro não mudar, vá para a Correção 2.

Verifique se funcionou

Abra o OSGeo4W Shell na pasta do QGIS no menu Iniciar e execute:

python -c "import torch; print(torch.__version__)"

Um número de versão sozinho em uma linha, sem traceback acima dele, significa que as DLLs carregaram. Agora repita o teste onde importa: no QGIS, Complementos, depois Console Python, depois import torch. Um prompt silencioso ali é o resultado que você quer. Se um dos dois testes passar e o outro falhar, eles estão executando Pythons diferentes. Volte à etapa 3.

Correção 2: falta uma dependência de fbgemm.dll

Algumas máquinas têm o pacote redistribuível e ainda assim não têm libomp140.x86_64.dll. A correção definitiva é migrar para o PyTorch 2.9.0 ou posterior, que não inclui fbgemm.dll. Se você está preso a uma versão mais antiga, usuários no rastreador do PyTorch relatam que copiar libomp140.x86_64.dll, que vem com o Visual Studio Community gratuito, faz o sistema funcionar. Isso é uma solução alternativa, nunca uma correção dos mantenedores, e nenhum wheel do PyTorch inclui o arquivo. Não baixe uma DLL avulsa de um site de downloads.

Se o erro não mudar, vá para a Correção 3.

Correção 3: o wheel não corresponde à máquina

Uma build CUDA em um computador sem um driver NVIDIA compatível falha na mesma linha. Sem uma GPU NVIDIA, force a build para CPU:

pip install --force-reinstall torch --index-url https://download.pytorch.org/whl/cpu

Com uma GPU, use o comando que a página de instalação do PyTorch fornece para a sua versão do CUDA. Dentro de um ambiente conda, instale o torch com conda em vez de pip, para que as bibliotecas de runtime venham do mesmo lugar que o pacote.

Se o erro não mudar, vá para a Correção 4.

Correção 4: o antivírus removeu um arquivo depois da instalação

Abra a Segurança do Windows, depois Proteção contra vírus e ameaças, depois Histórico de proteção. Restaure tudo o que ele removeu da sua pasta site-packages, adicione essa pasta às exclusões e reinstale o torch. A instalação informa que foi concluída e a pasta ainda parece cheia, então nada na tela aponta para esse problema.

Se o erro não mudar, vá para Ainda não funciona? abaixo.

Por que isso acontece

O PyTorch distribui DLLs compiladas, não apenas Python puro. fbgemm.dll e suas vizinhas em torch/lib fazem vínculo com o runtime C da Microsoft, e o Windows se recusa a carregar uma DLL quando não consegue encontrar as dependências dessa própria DLL. Ele informa a falha no topo da cadeia, em _C, o módulo de extensão do torch responsável pela importação. Por isso a mensagem nomeia um arquivo que está bem ali no disco.

A segunda causa é o Python 3.8. Desde essa versão, apenas os caminhos do sistema, o diretório que contém o arquivo DLL ou PYD e os diretórios adicionados com add_dll_directory() são pesquisados. PATH e o diretório de trabalho atual não são mais usados de forma alguma. Assim, uma máquina com Anaconda e QGIS pode entregar ao carregador um torch/lib do Python errado, e o erro não informa qual ele escolheu. Inicie o QGIS pelo próprio atalho no menu Iniciar, nunca a partir de um shell onde você executou conda activate.

Ainda não funciona?

AI Segmentation é o nosso plugin que instala PyTorch no Python do QGIS, então é ele que pode apresentar esse erro. Seus modos na nuvem executam os modelos nos nossos servidores e não precisam de torch local, mas isso não corrige o torch para nenhum outro plugin que precise dele. Envie a versão do QGIS, o traceback completo e a versão do plugin para . Diremos qual dos quatro casos é o seu.

Perguntas frequentes

Se você encontrar a mesma mensagem no GDAL, a versão _gdal deste erro tem suas próprias correções. Para saber o que a AI no QGIS faz depois que o torch carrega, comece pelo hub de AI do QGIS.

Faça no QGIS só pedindo

O AI Agent executa a tarefa que você descreve, no seu próprio projeto QGIS. Grátis, sem cartão.

Experimente o AI Agent grátis
Escrito porYvann Barbot
·8 min read

Continue lendo