Certifique-se de que o WSL esteja instalado no PC
- Para consertar o Docker Desktop: erro WSL inesperado, atualize o WSL, modifique o arquivo settings.json ou redefina o Winsock.
- O erro surge devido à falta de permissões, configurações de rede mal configuradas ou quando componentes críticos estão faltando.
- Leia este guia para descobrir como nossos especialistas consertaram as coisas rapidamente!

Docker Desktop permite aos usuários desenvolver, gerenciar e compartilhar aplicativos dockerizados, mas alguns, ao iniciar o aplicativo, receberam o Erro WSL inesperado.
Ele pode ser encontrado tanto no Windows quanto no Mac, embora tenhamos visto mais casos no primeiro. A maioria dos usuários que recentemente encontraram a mensagem de erro, Docker Desktop – Erro WSL inesperado, estavam executando o Windows 11.
O que é o erro WSL2 no Docker Desktop?
Erros WSL2 com Docker Desktop indicam permissões mal configuradas ou ausência de componentes críticos, especialmente o Plataforma de Máquina Virtual, um recurso opcional no Windows.
Além disso, se o próprio WSL não estiver instalado, nenhum comando WSL será executado. E até mesmo problemas de rede foram relatados como uma causa subjacente por muitos.
Como testamos, revisamos e avaliamos?
Trabalhamos nos últimos 6 meses na construção de um novo sistema de revisão sobre como produzimos conteúdo. Usando-o, refizemos posteriormente a maioria de nossos artigos para fornecer experiência prática real nos guias que criamos.
Para mais detalhes você pode ler como testamos, revisamos e avaliamos no WindowsReport.
Como faço para corrigir erros WSL inesperados no Docker Desktop?
Antes de nos aprofundarmos nas soluções um pouco complexas, tente estas soluções rápidas:
- Verifique se o seu dispositivo atende aos requisitos mínimos para Docker Desktop.
- Reinicie o PC. Se você precisar reinicializar todas as vezes para executar o Docker Desktop, tente as outras soluções.
- Verifique se há atualizações disponíveis e instale a versão mais recente do Docker Desktop a partir do website oficial. Além disso, atualize o sistema operacional. Ajudou muitos que se depararam com o Um erro inesperado ocorreu. Reinicie o Docker Desktop mensagem.
- Certifique-se de que o Docker Desktop esteja executando com privilégios administrativos para eliminar quaisquer problemas de direitos de acesso. Isso também ajuda quando Docker Desktop leva uma eternidade para iniciar.
- Desative qualquer antivírus de terceiros no PC.
Se nada funcionar, vá para as correções listadas a seguir.
- Como faço para corrigir erros WSL inesperados no Docker Desktop?
- 1. Instale WSL
- 2. Atualizar WSL
- 3. Modifique o arquivo settings.json
- 4. Alterar as configurações do prompt de comando
- 5. Redefinir WinSock
- 6. Habilite a virtualização de hardware no BIOS
- 7. Reinstale o WSL
- Qual é a alternativa para Docker Desktop no Windows WSL?
1. Instale WSL
- Imprensa janelas + S abrir Procurar, tipo Prompt de comando na barra de pesquisa e clique em Executar como administrador.
- Clique Sim no UAC incitar.
- Agora, cole o seguinte comando e clique Digitar para instalar o WSL:
wsl --install
- Uma vez feito isso, reinicie o PC e verifique se há melhorias.
Se o Subsistema Windows para Linux não estiver instalado, você receberá o Docker Desktop – Erro WSL inesperado. Depois de fazer isso, também ativar o Hyper-V no dispositivo. É fundamental que o Docker Desktop seja executado.
2. Atualizar WSL
- Imprensa janelas + R abrir Correr, tipo cmde bateu Ctrl + Mudança + Digitar.
- Clique Sim no prompt que aparece.
- Cole o seguinte comando e clique Digitar para atualizar o WSL:
wsl --update
- Se alguma atualização estiver instalada, reinicie o PC.
3. Modifique o arquivo settings.json
- Imprensa janelas + E abrir Explorador de arquivos, cole o seguinte caminho na barra de endereço e clique Digitar:
%Appdata%\Docker
- Clique duas vezes no configurações.json arquivo.
- Agora, certifique-se de que leia o seguinte:
"integratedWslDistros": [ ]
"enableIntegrationWithDefaultWslDistro": false - Se necessário, faça as edições necessárias e salve as alterações.
- Uma vez feito isso, reinicie o projeto e ele não deverá mais gerar o erro Docker Desktop falhou ao iniciar WSL2.
4. Alterar as configurações do prompt de comando
- Imprensa janelas + S abrir Procurar, tipo Prompt de comando, clique com o botão direito no resultado relevante e selecione Executar como administrador.
- Clique Sim no UAC prompt que aparece.
- Agora, clique com o botão direito na barra superior e selecione Propriedades no menu de contexto.
- Vou ao Opções guia, marque a caixa de seleção para Usar console legadoe clique em OK para salvar as alterações.
- ESPN está solicitando provedor de TV: como contorná-lo
- Resolvido: Spotify não reproduz certas músicas
5. Redefinir WinSock
- Imprensa janelas + R abrir Correr, tipo cmd, segurar Ctrl + Mudança teclas e cliquetudo bem.
- Clique Sim no prompt.
- Agora, cole os dois comandos a seguir individualmente e clique Digitar após cada um para redefinir as configurações de rede corrompidas ou mal configuradas:
netsh int ip reset
netsh winsock reset
- Reinicie o PC e verifique se o erro do Docker Desktop falhou ao iniciar desaparece.
6. Habilite a virtualização de hardware no BIOS
- Desligue o computador, ligue-o e, assim que a tela aparecer, continue pressionando o botão F2, F10, F12, Esc ou Del chave para acessar o BIOS, dependendo do fabricante do sistema.
- Agora, use as teclas de seta para ir para o Avançado ou Configuração do sistema guia e selecione Tecnologia de virtualização.
- Por fim, escolha Habilitare salve as alterações e saia do BIOS.
É vital ativar o suporte à virtualização no PC para que o Docker Desktop funcione corretamente. Na ausência disso, você poderá receber o Docker Desktop – Erro WSL inesperado.
7. Reinstale o WSL
- Imprensa janelas + EU abrir Configurações, Vá para Aplicativos no painel de navegação e clique em Aplicativos instalados à direita.
- Agora, localize Subsistema Windows para Linux, clique nas reticências ao lado dele e selecione Desinstalar.
- Novamente, clique Desinstalar no prompt de confirmação.
- Da mesma forma, remova as seguintes entradas dos aplicativos instalados, se existirem:
- Linux
- Ubuntu
- Agora, volte para o Aplicativos guia e selecione Recursos opcionais.
- Clique em Mais recursos do Windows no fundo.
- Desmarque a caixa de seleção para Plataforma de Máquina Virtual e Subsistema Windows para Linux, então clique OK para salvar as alterações.
- Reinicie o computador para que as alterações sejam aplicadas.
- Feito isso, reinstale o WSL (Windows Subsystem for Linux).
Quando nada mais funcionar, você sempre pode reinstalar o WSL e se livrar do Docker Desktop – Erro WSL inesperado. Começar por desinstalando WSL e baixe novamente todos os componentes.
Qual é a alternativa para Docker Desktop no Windows WSL?
Existem várias alternativas para o Docker Desktop, e muitos usuários estão mudando para elas, dadas as recentes mudanças nos termos de licença do projeto. Aqui estão as opções populares:
- Área de trabalho do fazendeiro
- Minikubo
- Podman
Ao mudar para outro software, certifique-se de verificar a compatibilidade com seu sistema operacional, conjunto de recursos, desempenho, facilidade de uso, eficiência da equipe de suporte e com que frequência as atualizações são lançadas.
Até agora você já deve ter se livrado do Docker Desktop – Erro WSL inesperado. E se não for esse o caso, espere por uma atualização ou mude para uma alternativa confiável. Você conhece todas as opções!
Além disso, existem outros erros de instalação que afetam os usuários. Por exemplo, muitos encontraram o Os recursos do Hyper-V e do contêiner do Windows devem estar habilitados erro ao instalar o Docker Desktop, mas é fácil de corrigir!
Para qualquer dúvida ou para compartilhar o que funcionou para você, deixe um comentário abaixo.