WSL2, WSA ou Docker não iniciam

Sintoma

O comando wsl termina com erro em vez de iniciar o Linux, o Docker Desktop informa que a virtualização ou o Hyper-V não estão disponíveis, e as aplicações Android e o emulador do Android Studio não iniciam.

Causas típicas

Os componentes de virtualização — Hyper-V e os associados — foram desativados pelo «otimizador», por um pacote de tweaks ou ficaram danificados após uma atualização falhada do Windows. Sem eles, o WSL2, o WSA e o Docker não conseguem iniciar as suas máquinas virtuais. A virtualização também é usada pelo subsistema de segurança: a forma como se relaciona com as definições do BoosterX está descrita no artigo «VBS (Virtualization Based Security)».

Correção no BoosterX

1. Abra o BoosterX → secção «Correções» (no menu à esquerda).
2. Na pesquisa, escreva «Linux».
3. Abra o cartão «Linux (WSL2), WSA (Android Studio), Docker» e clique em «Corrigir».
4. Reinicie o Windows.

A correção restaura o Hyper-V e ativa os componentes do Windows necessários para o funcionamento do WSL. O BoosterX pode ser descarregado do site oficial boosterx.org.

Como verificar

Abra o terminal e execute wsl — deve abrir-se a consola Linux. Depois inicie o Docker Desktop e a aplicação Android: ambos os ambientes devem arrancar sem erros de virtualização.

Alternativa manual sem BoosterX

Abra Painel de Controlo → Programas → Programas e Funcionalidades → Ativar ou desativar funcionalidades do Windows e assinale «Subsistema Windows para Linux» e «Plataforma de Máquina Virtual»; nas edições onde está disponível, também «Hyper-V». Clique em OK, aguarde a instalação dos componentes e reinicie o PC. Depois execute no terminal wsl --update para atualizar o kernel do WSL.

Se não ajudou

Se o Windows informar que a virtualização está desativada, verifique a sua ativação na BIOS/UEFI. A seguir, consulte os registos do Visualizador de Eventos do Windows que coincidam no tempo com o erro — a análise de incidentes é facilitada pelo EventX. Se a correção do BoosterX não ajudou ou o problema voltou, escreva para o suporte e anexe o texto do erro.

Última verificação: 2026-09-20. Catálogo completo de correções.