Si te has encontrado con el error ‘JAVA_HOME not found in your environment’ al intentar ejecutar una aplicación basada en Java en Windows, no estás solo. Este problema es bastante común y puede surgir por múltiples razones, desde una configuración incorrecta de variables de entorno hasta errores en la instalación del JDK. Afortunadamente, solucionarlo es más fácil de lo que parece.
En este artículo, veremos en detalle todas las posibles causas de este error y cómo solucionarlo paso a paso. Además, explicaremos las diferencias entre el JDK y el JRE, cómo configurar correctamente las variables de entorno y qué hacer si el error persiste en entornos como IntelliJ IDEA o Maven.
Causas del error ‘JAVA_HOME not found in your environment’
Antes de abordar las soluciones, es importante entender por qué aparece este error. Algunas de las razones más comunes incluyen:
- JAVA_HOME no está definido: La variable de entorno no se ha configurado o no está disponible en la terminal actual.
- Instalación incorrecta: El JDK no está instalado o la instalación está corrupta.
- Valor incorrecto en JAVA_HOME: La variable apunta a una ruta equivocada, como el directorio de la JRE en lugar del JDK.
- Uso del directorio \bin: No es correcto configurar JAVA_HOME apuntando al subdirectorio \bin del JDK.
Cómo comprobar si JAVA_HOME está configurado
Lo primero que debemos hacer es verificar si JAVA_HOME está definido y si apunta a la ubicación correcta. Para ello, abre una terminal en Windows (cmd o PowerShell) y ejecuta:
echo %JAVA_HOME%
Si el resultado está vacío o apunta a un directorio incorrecto, significa que la variable no está configurada correctamente.
Solución: Configurar JAVA_HOME en Windows
Paso 1: Instalar el JDK
Asegúrate de tener instalado el JDK y no solo el JRE. Puedes descargar la última versión del JDK desde el sitio web oficial de Oracle o de OpenJDK. Si necesitas ayuda sobre cómo manejar software en Windows, puedes consultar este artículo relacionado sobre errores de instalación en Windows.
Paso 2: Configurar la variable de entorno JAVA_HOME
- Haz clic en el menú de inicio y busca ‘Variables de entorno’.
- En la ventana que se abre, haz clic en ‘Variables de entorno’.
- En la sección Variables del sistema, haz clic en ‘Nueva’.
- Escribe JAVA_HOME como el nombre de la variable.
- En el campo de valor, introduce la ruta de instalación del JDK, por ejemplo:
C:\Program Files\Java\jdk-XX. - Haz clic en OK para guardar los cambios.
Paso 3: Agregar JAVA_HOME al PATH
Después de definir la variable JAVA_HOME, debemos agregarla al PATH para que el sistema la reconozca correctamente:
- En la misma ventana de variables de entorno, busca la variable Path y haz clic en Editar.
- Haz clic en Nuevo y añade
%JAVA_HOME%\bin. - Guarda los cambios y cierra todas las ventanas.
Paso 4: Verificar la configuración
Abre una nueva ventana de terminal y ejecuta:
echo %JAVA_HOME%
Si la ruta mostrada es correcta, prueba también con:
java -version
Si se muestra la versión instalada de Java, significa que todo está configurado correctamente.
Errores comunes al configurar JAVA_HOME
- Apuntar al directorio JRE en lugar del JDK: JAVA_HOME debe apuntar a la carpeta raíz del JDK, no a la subcarpeta JRE.
- Errores de sintaxis: En sistemas Unix/Linux, asegúrate de que el nombre de la variable respete mayúsculas y minúsculas (
JAVA_HOMEno es lo mismo quejava_home). - Variables no aplicadas: Si ya tenías una terminal abierta, ciérrala y ábrela de nuevo para que los cambios surtan efecto.
Errores en entornos específicos: IntelliJ IDEA y Maven
Algunos usuarios han reportado que el error de JAVA_HOME solo ocurre dentro de IntelliJ IDEA, aunque funcione bien en la terminal de Windows. Esto puede deberse a que IntelliJ no hereda correctamente las variables de entorno. Para solucionarlo:
- Abre IntelliJ IDEA y ve a File > Settings > Build, Execution, Deployment > Build Tools > Maven.
- En el campo JDK for importer, selecciona el JDK correcto.
- Reinicia IntelliJ IDEA y prueba de nuevo.
Si el error ocurre con Maven, verifica que en el archivo settings.xml no haya referencias incorrectas a una versión de Java desactualizada.
Siguiendo estos pasos, deberías poder resolver el error ‘JAVA_HOME not found in your environment’ en Windows y asegurarte de que tu sistema reconoce el JDK correctamente.
