WSL2 Parou de Funcionar? Diagnóstico e Correção do Erro `HCS_E_HYPERV_NOT_INSTALLED`

WSL2 Parou de Funcionar? Diagnóstico e Correção do Erro HCS_E_HYPERV_NOT_INSTALLED

Um guia para resolver causa-raiz, não sintoma.

Quando o WSL2 falha com esse erro, o problema não está na distro Linux. O erro está na camada de virtualização do host Windows.

Não há suporte para WSL2 com a configuração atual do computador.
Código de erro: Wsl/Service/CreateInstance/CreateVm/HCS/HCS_E_HYPERV_NOT_INSTALLED

Esse retorno é direto: o Host Compute Service (HCS) tentou provisionar a VM leve do WSL2 e não encontrou hypervisor ativo no kernel.

---

1) RCA: a cadeia de dependências do WSL2

O WSL2 depende de quatro elos. Se um quebra, tudo cai:

1. Hardware: virtualização habilitada na BIOS/UEFI (Intel VT-x / AMD SVM).
2. Kernel boot: hypervisor do Windows com hypervisorlaunchtype=Auto.
3. Features: VirtualMachinePlatform + Microsoft-Windows-Subsystem-Linux habilitadas.
4. Serviços: stack de virtualização operacional no boot.

Insight de operação

Já vi esse erro aparecer após update grande do Windows, hardening corporativo e até conflito com política de segurança (VBS/Device Guard). Em vários casos, a distro estava intacta e só a camada Hyper-V foi desligada no boot.

---

2) Diagnóstico rápido (sanity check)

2.1 Verificar virtualização no host

• Abrir Gerenciador de Tarefas -> Desempenho -> CPU
• Confirmar: Virtualização: Habilitado

Se estiver desabilitado, o problema é BIOS/UEFI, não Windows.

2.2 Confirmar status do hypervisor no BCD

bcdedit | findstr hypervisorlaunchtype

Se não vier Auto, o hypervisor não sobe no boot.

2.3 Validar features obrigatórias

dism.exe /online /get-featureinfo /featurename:VirtualMachinePlatform
dism.exe /online /get-featureinfo /featurename:Microsoft-Windows-Subsystem-Linux

Estado esperado: Enabled.

---

3) Correção estruturada

3.1 Reabilitar features do Windows

PowerShell como administrador:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

3.2 Corrigir boot do hypervisor

bcdedit /set hypervisorlaunchtype auto

Reinicie o host para aplicar no kernel.

3.3 Pós-reboot: validação de saúde

wsl --status
wsl -l -v

Se a distro continuar como versão 2 e subir normalmente, cadeia restaurada.

---

4) Troubleshooting avançado (quando ainda não sobe)

4.1 Verificar serviços de virtualização

Get-Service vmcompute,vmms,lxssmanager

Se algum estiver parado/disabled por política, o WSL2 pode falhar.

4.2 Validar conflitos com GPO/segurança

Ambientes corporativos podem bloquear Hyper-V indiretamente. Nesses casos, alinhar com time de segurança é obrigatório para liberar baseline mínima de virtualização.

4.3 Conferir logs de eventos

Abrir Event Viewer e filtrar fontes de Hyper-V / HCS para erro de inicialização de compute system.

---

5) Caso especial: nested virtualization

Se você está rodando Windows dentro de VM (Azure, AWS, Proxmox, lab local), WSL2 só funciona se nested virtualization estiver habilitada.

• Proxmox: CPU type host.
• Cloud: usar famílias/instâncias com suporte a nested virtualization.

Sem isso, o host convidado não consegue expor Hyper-V ao WSL2.

---

6) Plano de contingência: converter para WSL1

Se o ambiente bloqueia Hyper-V por compliance e não há exceção viável no curto prazo:

wsl --set-version <NomeDaDistro> 1

WSL1 não depende de VM, então volta a funcionar para scripts e automações básicas.

Trade-off técnico: menor compatibilidade e pior I/O para workloads modernos (ex.: Docker nativo com backend WSL2).

---

7) Checklist preventivo (baseline de imagem)

• [ ] Documentar hypervisorlaunchtype=Auto no baseline de workstation.
• [ ] Validar features WSL após grandes updates do Windows.
• [ ] Monitorar se hardening não desativa Hyper-V silenciosamente.
• [ ] Incluir teste pós-update:

wsl --status
wsl -l -v

• [ ] Em ambiente virtualizado, validar nested virtualization antes de provisionar dev boxes.

---

Conclusão

HCS_E_HYPERV_NOT_INSTALLED não é bug da distro. É falha de orquestração da camada de virtualização no host.

Quando você trata a cadeia completa (BIOS -> BCD -> Features -> Serviços), o tempo de recuperação cai drasticamente e para de existir “reinstala Ubuntu” como solução mágica.

Infra previsível começa com diagnóstico limpo e correção na camada certa.

Este post está licenciado sob CC BY-NC.