O erro 0x80370102 do WSL exibe a mensagem The virtual machine could not be started because a required feature is not installed. Ele significa que a máquina virtual do WSL 2 não pode iniciar porque um pré-requisito de virtualização está ausente ou desativado. O erro pode ocorrer ao instalar, registrar, converter ou iniciar uma distribuição no Windows 11 ou em uma compilação qualificada do Windows 10. Primeiro, determine se o Windows está sendo executado em um PC físico ou dentro de uma máquina virtual. Em um PC físico, a ação inicial mais segura é habilitar a Plataforma de Máquina Virtual, se necessário, e concluir a reinicialização exigida.

O que significa o erro 0x80370102 do WSL

A mesma falha pode aparecer como WslRegisterDistribution failed with error: 0x80370102, Wsl/Service/CreateInstance/CreateVm/0x80370102 ou como uma mensagem solicitando que você habilite a Plataforma de Máquina Virtual e a virtualização no BIOS. Esses são indicadores equivalentes de falha na inicialização da virtualização do WSL 2, e não erros separados.

O próprio WSL ou a distribuição Linux talvez já esteja instalado. A falha ocorre porque a máquina virtual do WSL 2 não pode iniciar. Por si só, ela não indica que a distribuição está corrompida.

Contexto do Windows Primeiro pré-requisito a verificar
PC físico Plataforma de Máquina Virtual, seguida da virtualização no firmware
Hardware físico mais antigo Suporte da CPU a Conversão de Endereço de Segundo Nível (SLAT)
Windows em uma VM do Hyper-V Virtualização aninhada exposta pelo host pai
Pré-requisitos aplicáveis já confirmados Configuração de inicialização do hipervisor do Windows

A Microsoft documenta esse erro e suas ramificações de pré-requisitos na documentação de solução de problemas do WSL da Microsoft. O contexto atual de instalação do WSL requer Windows 10 versão 2004 ou posterior, ou Windows 11. A documentação de instalação manual da Microsoft também lista limites restritos para compilações mais antigas do Windows 10, incluindo a versão 1903 x64, compilação 18362.1049 ou posterior. A elegibilidade técnica da compilação não determina se uma versão do Windows 10 permanece dentro de seu ciclo de suporte atual.

Corrigir o erro 0x80370102 em um PC físico com Windows

Habilite a Plataforma de Máquina Virtual e reinicie

Quando se aplica: Use este caminho em um PC físico quando não houver confirmação de que a Plataforma de Máquina Virtual já está habilitada. O procedimento oficial fornecido não inclui um comando separado para verificar o recurso. Se o componente já tiver sido habilitado e o Windows tiver sido reiniciado depois disso, prossiga para a verificação da virtualização no firmware.

Pré-requisitos: Você precisa de acesso de administrador e de uma versão do Windows compatível com o WSL 2. Os limites de compilação documentados pela Microsoft e o comando estão disponíveis nos requisitos de instalação manual do WSL da Microsoft.

  1. Abra o PowerShell como administrador.
  2. Execute dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart.
  3. Reinicie o computador. A reinicialização é obrigatória antes que o componente seja ativado.
  4. Tente novamente a instalação do WSL, o registro da distribuição, a conversão para WSL 2 ou a inicialização da distribuição que gerou o erro 0x80370102.

Resultado esperado: O Windows ativa o componente Plataforma de Máquina Virtual para que o WSL 2 possa usá-lo. Outro pré-requisito indisponível ainda pode impedir a inicialização da máquina virtual.

Risco e reversão: Esta é uma alteração de baixo risco em um recurso do Windows e não exclui dados da distribuição. É necessário acesso de administrador. Se necessário, desabilite o recurso Plataforma de Máquina Virtual para retornar ao estado anterior do recurso; nenhum comando de desativação não verificado é fornecido aqui.

Habilite a virtualização no firmware, no BIOS ou UEFI

Quando se aplica: Use este caminho em um PC físico se a Plataforma de Máquina Virtual estiver habilitada, a reinicialização obrigatória do Windows tiver sido concluída e o erro 0x80370102 continuar.

Pré-requisitos: Obtenha as instruções de BIOS ou UEFI para o PC ou a placa-mãe exata. Os nomes dos menus do firmware e os métodos de acesso variam conforme o fabricante; portanto, sequências de teclas ou rótulos de menu universais não são confiáveis.

  1. Abra as configurações de firmware do computador seguindo as instruções do fabricante.
  2. Habilite o suporte à virtualização da CPU no BIOS ou UEFI.
  3. Salve a alteração de firmware e saia da configuração.
  4. Reinicie o Windows.
  5. Tente novamente a operação do WSL 2.

Resultado esperado: O Windows pode usar o recurso de virtualização do processador, desde que a CPU também seja compatível com SLAT e não haja outro pré-requisito aplicável ausente.

Risco e reversão: Esta é uma alteração de firmware de risco médio. Registre a configuração original, pois mudanças na virtualização podem afetar outros hipervisores ou configurações de segurança. Para reverter, entre novamente na interface do firmware e restaure a configuração anterior de virtualização.

Confirme se a CPU é compatível com SLAT

Quando se aplica: Verifique esse requisito quando o dispositivo puder ser antigo demais para o WSL 2 ou quando a habilitação das configurações documentadas do Windows e do firmware não resolver a falha de inicialização.

Pré-requisito: Você precisa acessar as informações do sistema do Windows ou especificações confiáveis do processador instalado.

  1. Identifique o processador e verifique se ele é compatível com Second Level Address Translation (SLAT), ou Conversão de Endereço de Segundo Nível.
  2. Confirme a capacidade usando as informações do sistema do Windows ou especificações confiáveis do hardware, em vez de presumir que toda CPU de 64 bits a oferece.
  3. Se o processador for anterior ao Intel Nehalem ou AMD Opteron e não tiver a capacidade necessária, pare de tentar forçar o WSL 2 e considere a alternativa do WSL 1.

Resultado esperado: Essa verificação diferencia um problema de virtualização configurável de uma limitação de hardware sem suporte. Alterações no firmware não podem adicionar SLAT a um processador que não oferece esse recurso.

Risco e reversão: Este é um diagnóstico somente de leitura e de baixo risco, sem alterações no sistema.

Corrigir o erro 0x80370102 quando o Windows é executado em uma VM do Hyper-V

Quando o próprio Windows é convidado do Hyper-V, habilitar configurações de virtualização nesse convidado não é suficiente. O host pai do Hyper-V precisa expor extensões de virtualização ao convidado. Esta ramificação exige acesso ao host e não se aplica automaticamente a hipervisores de terceiros ou de nuvem.

Quando se aplica: Use este caminho somente quando o WSL 2 estiver sendo executado dentro de uma máquina virtual Windows do Hyper-V.

Pré-requisitos: Você precisa de acesso de administrador ao host pai do Hyper-V e do nome real da VM convidada do Windows.

  1. No host pai do Hyper-V, abra o PowerShell como administrador.
  2. Execute Set-VMProcessor -VMName <VMName> -ExposeVirtualizationExtensions $true.
  3. Substitua <VMName> pelo nome real do convidado; não digite o espaço reservado literalmente.
  4. Inicie ou reinicie o convidado do Windows.
  5. Tente novamente usar o WSL 2 dentro do convidado.

Resultado esperado: O host pai expõe as extensões de virtualização necessárias para o WSL 2 dentro do convidado. A Microsoft explica esse requisito de host na documentação sobre virtualização aninhada do Hyper-V.

Risco e reversão: Esta é uma alteração de risco médio na configuração do processador da VM. Para remover as extensões expostas, execute o mesmo comando no host pai com $false em vez de $true. Não aplique esse comando do Hyper-V a outra plataforma de virtualização. Para um hipervisor de terceiros, consulte a documentação atual e específica da versão sobre compatibilidade.

Verifique a configuração de inicialização do hipervisor se os pré-requisitos estiverem habilitados

Quando se aplica: Use esta ramificação avançada somente depois de confirmar o recurso aplicável do Windows, a reinicialização obrigatória, a virtualização no firmware, o suporte a SLAT e o requisito de virtualização aninhada. Ela se aplica quando o WSL 2 ainda não consegue criar sua máquina virtual porque o Windows está configurado para não iniciar o hipervisor.

Pré-requisito: É necessário acesso de administrador. Alterar essa configuração pode afetar softwares que dependem de outro estado do hipervisor do Windows.

  1. Abra o PowerShell como administrador.
  2. Execute bcdedit /enum | findstr -i hypervisorlaunchtype.
  3. Se o resultado mostrar Off, execute bcdedit /set hypervisorlaunchtype Auto.
  4. Reinicie o Windows.
  5. Tente novamente a operação do WSL 2 que falhou.

Resultado esperado: Quando o valor anterior era Off, o Windows pode iniciar o hipervisor durante a inicialização. Isso não resolve a falta de suporte a SLAT nem a indisponibilidade de virtualização aninhada.

Risco e reversão: Esta é uma alteração de risco médio na configuração de inicialização. Se for necessário restaurar o estado anterior, defina hypervisorlaunchtype novamente como Off e reinicie o computador.

Use o WSL 1 quando o WSL 2 não estiver disponível

Quando se aplica: Use o WSL 1 como alternativa somente quando o hardware não puder oferecer suporte ao WSL 2 ou quando o provedor de máquinas virtuais não puder disponibilizar virtualização aninhada. Ele não é a solução principal para um pré-requisito desativado que possa ser habilitado com segurança.

Pré-requisitos: O WSL deve estar instalado, e a distribuição já deve estar presente ou ser instalável. Se uma distribuição existente contiver dados importantes, exporte-a ou faça backup antes da conversão. Os comandos exatos de backup e conversão foram intencionalmente omitidos porque não foram fornecidos no procedimento confirmado.

  1. Exporte ou faça backup da distribuição existente quando for necessário preservar os dados.
  2. Configure a distribuição para usar o WSL 1 em vez do WSL 2, seguindo a documentação atual do WSL da Microsoft.
  3. Continue usando a distribuição considerando as limitações do WSL 1.

Resultado esperado: A distribuição usa o WSL 1 em vez da arquitetura de máquina virtual do WSL 2. O WSL 1 não é funcionalmente idêntico ao WSL 2; portanto, consulte a documentação atual do WSL da Microsoft sobre diferenças de recursos e compatibilidade antes de selecionar essa alternativa.

Risco e reversão: A alternativa tem baixo risco quando os dados da distribuição foram preservados. Se os pré-requisitos do WSL 2 estiverem disponíveis mais tarde, a distribuição poderá ser convertida novamente para WSL 2 após outro backup.

O que coletar se o erro 0x80370102 continuar

Se todos os pré-requisitos aplicáveis já estiverem confirmados e o erro permanecer, colete evidências antes de encaminhar o caso. Isso ajuda a diferenciar um problema do Microsoft Windows de uma limitação do firmware, do processador ou do host de virtualização.

  • O código de erro exato e a mensagem completa, incluindo qualquer texto WslRegisterDistribution ou CreateInstance/CreateVm.
  • A edição, a versão e a compilação do Windows.
  • Se o Windows é executado em hardware físico ou dentro de uma máquina virtual.
  • Se a Plataforma de Máquina Virtual foi habilitada e se a reinicialização obrigatória foi concluída.
  • Se a virtualização no firmware está habilitada em um PC físico.
  • O modelo do processador e a fonte confiável usada para confirmar o suporte a SLAT.
  • Para uma máquina virtual, o hipervisor pai e se as extensões de virtualização foram expostas.
  • O valor informado de hypervisorlaunchtype e se ele foi alterado.
  • A ação que falhou: instalação do WSL, registro da distribuição, inicialização ou conversão de WSL 1 para WSL 2.

Encaminhe o caso à Microsoft para uma falha do Windows ou do WSL após a confirmação de todos os requisitos, ao fabricante do dispositivo para dúvidas sobre firmware ou processador, ou ao provedor de virtualização quando a virtualização aninhada não estiver disponível. Não redefina, cancele o registro nem reinstale a distribuição apenas por causa deste erro: as evidências oficiais fornecidas não confirmam essas ações potencialmente disruptivas como soluções.

Evite soluções sem suporte

  • Não use edições não documentadas do Registro.
  • Não presuma que habilitar apenas o Hyper-V substitui a Plataforma de Máquina Virtual, a virtualização no firmware, SLAT ou a virtualização aninhada.
  • Não faça alterações genéricas em recursos ou serviços do Hyper-V que não estejam relacionadas ao pré-requisito diagnosticado.
  • Não ignore a reinicialização após habilitar a Plataforma de Máquina Virtual ou alterar a virtualização no firmware.
  • Não continue forçando o WSL 2 em um processador sem SLAT.

Outros erros do Windows

Se o código não for 0x80370102, use um guia específico para o erro. Os procedimentos para o erro de atualização 0x80070005 e para o erro Add-AppxPackage 0x80073D02 não se aplicam a este erro de virtualização do WSL 2.