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

[Resolvido] DLL load failed importing _gdal no QGIS

Publicado em Atualizado em

ImportError: DLL load failed while importing _gdal interrompe qualquer Python que execute from osgeo import gdal dentro do QGIS no Windows, incluindo o Processing Toolbox. Uma segunda cópia do GDAL fica antes da do QGIS no seu PATH, então remova essas pastas que não são do QGIS do PATH e saia da sessão do Windows antes de entrar novamente. Na maioria das máquinas, essa é toda a correção. As quatro abaixo cobrem o restante.

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

On Windows, with Python >= 3.8, DLLs are no longer imported from the PATH.
If gdalXXX.dll is in the PATH, then set the USE_PATH_FOR_GDAL_PYTHON=YES environment variable
to feed the PATH into os.add_dll_directory().

O GDAL removeu essa dica de três linhas na versão 3.7.0. Portanto, em uma instalação atual, você recebe apenas a primeira linha. Em algumas máquinas, uma palavra muda, mas a causa é a mesma:

ImportError: DLL load failed while importing _gdal: The specified procedure could not be found.

A maioria das pessoas nunca lê nenhum dos dois textos. Elas encontram o problema como uma única linha no painel QGIS Log Messages e um menu Processing vazio:

Couldn't load plugin 'processing'

Aplica-se ao Windows, ao QGIS 3.16 e posteriores, e a qualquer Python 3.8 ou mais recente que execute from osgeo import gdal.

A correção rápida

  1. Liste todas as pastas do PATH que contêm uma DLL do GDAL

    Abra o OSGeo4W Shell na pasta do QGIS, no Start menu, e execute isto, que repete a própria lógica do GDAL:

    python -c "import os,glob;print('\n'.join(p for p in os.environ['PATH'].split(';') if p and (glob.glob(os.path.join(p,'gdal*.dll')) or glob.glob(os.path.join(p,'libgdal*.dll')))))"
    

    Leia a primeira linha. Essa é a pasta usada pelo GDAL, e ela deve estar dentro da sua instalação do QGIS. Guarde toda a saída, pois cada correção abaixo usa essas informações.

  2. Exclua as entradas que não são do QGIS

    Anaconda, Miniconda, uma segunda instalação do QGIS ou do OSGeo4W, ou outro pacote GIS. Abra o Start, digite "environment variables", abra Edit the system environment variables, depois Environment Variables, depois Path, e exclua essas entradas. Saia da sessão do Windows e entre novamente.

  3. Inicie o QGIS pelo próprio atalho

    Não a partir de um shell no qual você já executou o script activate de outro ambiente. Um shell que colocou um caminho gdal-dev primeiro o entrega diretamente ao QGIS.

Verifique se funcionou

No QGIS, abra Plugins, depois Python Console, e execute:

from osgeo import gdal
print(gdal.__version__)

Um número de versão sem traceback acima dele significa que as DLLs corretas foram carregadas. Abra também o menu Processing, porque o Toolbox volta no momento em que o plugin processing consegue importar o GDAL. Um menu Processing vazio significa que o problema ainda não foi resolvido.

Correção 2: execute seu script dentro do ambiente do QGIS

A Etapa 1 não exibiu nada. Nenhuma pasta do seu PATH contém uma DLL do GDAL, então nada foi registrado. Isso acontece quando um python.exe comum ou uma configuração de execução do PyCharm é iniciada fora do ambiente do QGIS. Execute o script no OSGeo4W Shell ou por meio de python-qgis.bat na pasta bin do QGIS. Em uma instalação de versão de suporte prolongado, esse arquivo se chama python-qgis-ltr.bat. Ambos registram a pasta correta das DLLs antes de o Python iniciar.

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

Correção 3: repare uma instalação do OSGeo4W atualizada pela metade

A Etapa 1 exibiu várias linhas, e todas ficam dentro da mesma árvore do OSGeo4W. Você está carregando gdal e gdal-dev ao mesmo tempo, devido a uma atualização que foi interrompida no meio. Execute novamente o instalador do OSGeo4W e reinstale os pacotes gdal e qgis, ou reinstale o QGIS pelo instalador independente, que é a saída mais rápida.

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

Correção 4: defina USE_PATH_FOR_GDAL_PYTHON

A Etapa 1 exibiu uma linha, a do QGIS, e a importação ainda falha. Agora vale a pena tentar definir a variável, e somente agora. No QGIS: Settings, depois Options, depois System, depois o grupo Environment. Marque a caixa de variáveis personalizadas, adicione este nome e valor e reinicie o QGIS:

USE_PATH_FOR_GDAL_PYTHON=YES

Isso ajuda uma pequena minoria das pessoas, pelo motivo explicado em "Por que isso acontece".

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

Correção 5: mantenha um GDAL por ambiente conda

Seu GDAL vem do conda. Use apenas o conda-forge, em um ambiente novo, e nunca misture um wheel de GDAL do pip no mesmo local. Um canal, uma cópia.

Se o erro não mudar, envie-me as três informações abaixo.

Por que isso acontece

O Python 3.8 parou de procurar DLLs de extensão no PATH. O GDAL contorna isso em osgeo/__init__.py. Com USE_PATH_FOR_GDAL_PYTHON não definida, o GDAL lê o PATH em ordem, registra a primeira pasta que contém uma gdal*.dll ou libgdal*.dll com os.add_dll_directory() e para de procurar. Portanto, o primeiro GDAL do seu PATH vence. Quando essa cópia não é a do QGIS, suas DLLs não correspondem ao módulo _gdal contra o qual o QGIS foi compilado.

Definir a variável amplia essa busca em vez de restringi-la, porque o GDAL passa a registrar todas as pastas do PATH e não usa nenhum glob. Por isso, a linha que costumava ser exibida pela mensagem de erro ajuda quase ninguém.

Nosso plugin AI Segmentation lê rasters por meio do GDAL que o QGIS já fornece e não instala nenhum GDAL próprio. Portanto, ele funciona assim que a importação acima funciona. O restante do que desenvolvemos para o QGIS está na página QGIS AI.

Ainda não funciona?

Envie-me três informações: sua versão do QGIS, o traceback completo e a saída da verificação do PATH na etapa 1 da correção rápida. Meu endereço é . A primeira linha dessa saída geralmente basta para dizer em qual dos cinco casos você se encontra.

Perguntas frequentes

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