El error 0x80370102 de WSL muestra el mensaje The virtual machine could not be started because a required feature is not installed. Significa que la máquina virtual de WSL 2 no puede iniciarse porque falta un requisito de virtualización o está desactivado. El error puede aparecer al instalar, registrar, convertir o iniciar una distribución en Windows 11 o en una compilación compatible de Windows 10. Primero determine si Windows se ejecuta en un equipo físico o dentro de una máquina virtual; en un equipo físico, la acción inicial más segura es habilitar Plataforma de máquina virtual si es necesario y completar el reinicio requerido.

Qué significa el error 0x80370102 de WSL

El mismo fallo puede aparecer como WslRegisterDistribution failed with error: 0x80370102, Wsl/Service/CreateInstance/CreateVm/0x80370102 o como un mensaje que solicita habilitar Plataforma de máquina virtual y la virtualización en el BIOS. Estas son firmas equivalentes de un fallo de inicio de virtualización de WSL 2, no errores independientes.

Es posible que WSL o la distribución de Linux ya estén instalados. El fallo se produce porque la máquina virtual de WSL 2 no puede iniciarse. Por sí solo, no demuestra que la distribución esté dañada.

Contexto de Windows Primer requisito que se debe comprobar
Equipo físico Plataforma de máquina virtual y, después, virtualización del firmware
Hardware físico antiguo Compatibilidad de la CPU con la traducción de direcciones de segundo nivel (SLAT)
Windows dentro de una máquina virtual Hyper-V Virtualización anidada expuesta por el host principal
Requisitos aplicables ya confirmados Configuración de inicio del hipervisor de Windows

Microsoft documenta este error y sus ramas de requisitos previos en la guía de solución de problemas de WSL de Microsoft. El contexto de instalación actual de WSL requiere Windows 10 versión 2004 o posterior, o Windows 11. La documentación de instalación manual de Microsoft también enumera umbrales limitados para compilaciones anteriores de Windows 10, incluida la versión 1903 x64, compilación 18362.1049 o posterior. La compatibilidad técnica de una compilación no determina que una versión de Windows 10 siga dentro de su ciclo de soporte actual.

Solucionar el error 0x80370102 en un equipo físico con Windows

Habilite Plataforma de máquina virtual y reinicie

Cuándo se aplica: Use esta opción en un equipo físico cuando no se sepa que Plataforma de máquina virtual ya está habilitada. El procedimiento oficial proporcionado no incluye un comando independiente para comprobar la característica; si el componente ya se habilitó y Windows se reinició después, continúe con la comprobación de virtualización del firmware.

Requisitos previos: Necesita acceso de administrador y una versión de Windows compatible con WSL 2. Los límites de compilación y el comando documentados por Microsoft están disponibles en los requisitos de instalación de WSL de Microsoft.

  1. Abra PowerShell como administrador.
  2. Ejecute dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart.
  3. Reinicie el equipo. El reinicio es necesario antes de que el componente esté activo.
  4. Vuelva a intentar la instalación de WSL, el registro de la distribución, la conversión a WSL 2 o el inicio de la distribución que produjo el error 0x80370102.

Resultado esperado: Windows activa el componente Plataforma de máquina virtual para que WSL 2 pueda usarlo. Otro requisito no disponible aún puede impedir que se inicie la máquina virtual.

Riesgo y reversión: Este es un cambio de característica de Windows de bajo riesgo y no elimina los datos de la distribución. Se requiere acceso de administrador. Si es necesario, deshabilite la característica Plataforma de máquina virtual para volver al estado anterior; aquí no se proporciona un comando de deshabilitación no verificado.

Habilite la virtualización del firmware en el BIOS o UEFI

Cuándo se aplica: Use esta opción en un equipo físico si Plataforma de máquina virtual está habilitada, se completó el reinicio requerido de Windows y el error 0x80370102 continúa.

Requisitos previos: Obtenga las instrucciones de BIOS o UEFI para el equipo o la placa base exactos. Los nombres de los menús del firmware y los métodos de acceso varían según el fabricante, por lo que las secuencias de teclas o etiquetas de menú universales no son fiables.

  1. Abra la configuración del firmware del equipo siguiendo las instrucciones del fabricante.
  2. Habilite la compatibilidad con virtualización de CPU en el BIOS o UEFI.
  3. Guarde el cambio del firmware y salga de la configuración.
  4. Reinicie Windows.
  5. Vuelva a intentar la operación de WSL 2.

Resultado esperado: Windows puede utilizar la capacidad de virtualización del procesador, siempre que la CPU también admita SLAT y no falte otro requisito aplicable.

Riesgo y reversión: Este es un cambio de firmware de riesgo medio. Anote la configuración original, ya que los cambios de virtualización pueden afectar a otros hipervisores o configuraciones de seguridad. Para revertirlo, vuelva a entrar en la interfaz del firmware y restaure la configuración de virtualización anterior.

Confirme que la CPU admite SLAT

Cuándo se aplica: Compruebe este requisito cuando el dispositivo pueda ser demasiado antiguo para WSL 2 o cuando habilitar la configuración documentada de Windows y del firmware no resuelva el fallo de inicio.

Requisito previo: Necesita acceso a la información del sistema de Windows o a especificaciones acreditadas del procesador instalado.

  1. Identifique el procesador y compruebe si admite la traducción de direcciones de segundo nivel, o SLAT.
  2. Confirme la capacidad mediante la información del sistema de Windows o especificaciones de hardware acreditadas, en lugar de asumir que todas las CPU de 64 bits la admiten.
  3. Si el procesador es anterior a Intel Nehalem o AMD Opteron y no tiene la capacidad requerida, deje de intentar forzar WSL 2 y considere usar WSL 1 como alternativa.

Resultado esperado: Esta comprobación distingue un problema de virtualización configurable de hardware no compatible. Los cambios de firmware no pueden añadir SLAT a un procesador que no lo admite.

Riesgo y reversión: Este es un diagnóstico de solo lectura y bajo riesgo que no realiza cambios en el sistema.

Solucionar el error 0x80370102 cuando Windows se ejecuta en una máquina virtual Hyper-V

Cuando Windows es un invitado de Hyper-V, no basta con habilitar la configuración de virtualización dentro de ese invitado. El host principal de Hyper-V debe exponer extensiones de virtualización al invitado. Esta opción requiere acceso al host y no se aplica automáticamente a hipervisores de terceros o en la nube.

Cuándo se aplica: Use esta opción únicamente cuando WSL 2 se ejecute dentro de una máquina virtual Windows de Hyper-V.

Requisitos previos: Necesita acceso de administrador en el host principal de Hyper-V y el nombre real de la máquina virtual invitada de Windows.

  1. En el host principal de Hyper-V, abra PowerShell como administrador.
  2. Ejecute Set-VMProcessor -VMName <VMName> -ExposeVirtualizationExtensions $true.
  3. Sustituya <VMName> por el nombre real del invitado; no escriba el marcador de posición literalmente.
  4. Inicie o reinicie el invitado de Windows.
  5. Vuelva a intentar usar WSL 2 dentro del invitado.

Resultado esperado: El host principal expone las extensiones de virtualización que WSL 2 necesita dentro del invitado. Microsoft explica este requisito del host en su documentación sobre virtualización anidada de Hyper-V.

Riesgo y reversión: Este es un cambio de configuración del procesador de la máquina virtual de riesgo medio. Para quitar las extensiones expuestas, ejecute el mismo comando en el host principal con $false en lugar de $true. No aplique este comando de Hyper-V a otra plataforma de virtualización. Para un hipervisor de terceros, consulte su documentación actual de compatibilidad específica de la versión.

Compruebe la configuración de inicio del hipervisor si los requisitos están habilitados

Cuándo se aplica: Use esta opción avanzada únicamente después de confirmar la característica de Windows aplicable, el reinicio requerido, la virtualización del firmware, la compatibilidad con SLAT y el requisito de virtualización anidada. Se aplica cuando WSL 2 sigue sin poder crear su máquina virtual porque Windows está configurado para no iniciar el hipervisor.

Requisito previo: Se requiere acceso de administrador. Cambiar esta configuración puede afectar al software que depende de un estado diferente del hipervisor de Windows.

  1. Abra PowerShell como administrador.
  2. Ejecute bcdedit /enum | findstr -i hypervisorlaunchtype.
  3. Si el resultado muestra Off, ejecute bcdedit /set hypervisorlaunchtype Auto.
  4. Reinicie Windows.
  5. Vuelva a intentar la operación de WSL 2 que falló.

Resultado esperado: Si el valor anterior era Off, Windows puede iniciar el hipervisor durante el arranque. Esto no resuelve la falta de compatibilidad con SLAT ni una virtualización anidada no disponible.

Riesgo y reversión: Este es un cambio de configuración de arranque de riesgo medio. Si debe restaurar el estado anterior, establezca de nuevo hypervisorlaunchtype en Off y reinicie Windows.

Use WSL 1 cuando WSL 2 no esté disponible

Cuándo se aplica: Use WSL 1 como alternativa únicamente cuando el hardware no pueda admitir WSL 2 o cuando el proveedor de máquinas virtuales no pueda habilitar la virtualización anidada. No es la solución principal para un requisito desactivado que puede habilitarse de forma segura.

Requisitos previos: WSL debe estar instalado y la distribución debe estar presente o poder instalarse. Si una distribución existente contiene datos importantes, expórtela o cree una copia de seguridad antes de convertirla. Los comandos exactos de copia de seguridad y conversión se omiten intencionadamente porque no se proporcionaron en el procedimiento confirmado.

  1. Exporte o cree una copia de seguridad de la distribución existente cuando sea importante conservarla.
  2. Configure la distribución para usar WSL 1 en lugar de WSL 2 siguiendo la documentación actual de Microsoft sobre WSL.
  3. Siga usando la distribución teniendo en cuenta las limitaciones de WSL 1.

Resultado esperado: La distribución usa WSL 1 en vez de la arquitectura de máquina virtual de WSL 2. WSL 1 no es funcionalmente idéntico a WSL 2, por lo que debe revisar la documentación actual de Microsoft sobre WSL para conocer las diferencias de características y compatibilidad antes de elegir esta alternativa.

Riesgo y reversión: La alternativa es de bajo riesgo cuando se han conservado los datos de la distribución. Si los requisitos de WSL 2 están disponibles más adelante, la distribución se puede volver a convertir a WSL 2 después de crear otra copia de seguridad.

Qué recopilar si el error 0x80370102 continúa

Si todos los requisitos aplicables ya están confirmados y el error persiste, recopile evidencias antes de escalar el caso. Esto ayuda a distinguir un problema de Microsoft Windows de una limitación del firmware, el procesador o el host de virtualización.

  • El código de error exacto y el mensaje completo, incluido cualquier texto WslRegisterDistribution o CreateInstance/CreateVm.
  • La edición, versión y compilación de Windows.
  • Si Windows se ejecuta en hardware físico o dentro de una máquina virtual.
  • Si se habilitó Plataforma de máquina virtual y se completó el reinicio requerido.
  • Si la virtualización del firmware está habilitada en un equipo físico.
  • El modelo de procesador y la fuente acreditada usada para confirmar la compatibilidad con SLAT.
  • Para una máquina virtual, el hipervisor principal y si se expusieron extensiones de virtualización.
  • El valor de hypervisorlaunchtype informado y si se modificó.
  • La acción que falló: instalación de WSL, registro de la distribución, inicio o conversión de WSL 1 a WSL 2.

Escále el caso a Microsoft ante un fallo de Windows o WSL después de confirmar todos los requisitos; al fabricante del dispositivo para preguntas sobre firmware o procesador; o al proveedor de virtualización cuando la virtualización anidada no esté disponible. No restablezca, anule el registro ni reinstale la distribución únicamente por este error: las evidencias oficiales proporcionadas no confirman estas acciones potencialmente disruptivas como soluciones.

Evite soluciones no compatibles

  • No use modificaciones no documentadas del Registro.
  • No suponga que habilitar Hyper-V por sí solo sustituye Plataforma de máquina virtual, la virtualización del firmware, SLAT o la virtualización anidada.
  • No realice cambios generales en características o servicios de Hyper-V que no estén relacionados con el requisito diagnosticado.
  • No omita el reinicio después de habilitar Plataforma de máquina virtual o cambiar la virtualización del firmware.
  • No siga forzando WSL 2 en un procesador sin SLAT.

Errores de Windows diferentes

Si el código no es 0x80370102, utilice una guía específica para ese error. Los procedimientos para otros errores de Windows, como los fallos de acceso denegado de Windows Update o los bloqueos de recursos durante la implementación de AppX/MSIX, no se aplican a este error de virtualización de WSL 2.

Preguntas frecuentes

¿Qué significa el error 0x80370102 de WSL?

Indica que WSL 2 no puede iniciar su máquina virtual porque falta un requisito de virtualización o está desactivado. No confirma por sí solo que la distribución de Linux esté dañada.

¿Debo reiniciar después de habilitar Plataforma de máquina virtual?

Sí. El reinicio es necesario para que el componente se active antes de volver a intentar la operación de WSL 2.

¿Puedo usar WSL 2 dentro de una máquina virtual Hyper-V?

Sí, pero el host principal de Hyper-V debe exponer extensiones de virtualización al invitado mediante virtualización anidada.

¿WSL 1 puede ser una alternativa?

Sí, cuando el hardware no admite WSL 2 o el proveedor de virtualización no puede ofrecer virtualización anidada. Realice una copia de seguridad de los datos importantes de la distribución antes de convertirla.