Maven CLI не распознает JAVA_HOME как правильно настроенную.

Вопрос или проблема

C:\Users\{usr}>mvn -version
Переменная окружения JAVA_HOME определена неправильно
Эта переменная окружения необходима для запуска этой программы
NB: JAVA_HOME должен указывать на JDK, а не на JRE

C:\Users\{usr}>echo %JAVA_HOME%
C:\Program Files\Java\jdk1.8.0_191

Apache Maven 3.6.1 (d66c9c0b3152b2e69ee9bac180bb8fcc8e6af555; 2019-04-05T03:00:29+08:00)
Maven home: C:\Program Files\Maven\apache-maven-3.6.1\bin\..
Java version: 1.8.0_191, vendor: Oracle Corporation, runtime: C:\Program Files\Java\jre1.8.0_191
Default locale: en_PH, platform encoding: Cp1252
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

<profile>
  <id>myprofile</id>

  <activation>
    <jdk>1.8</jdk>
  </activation>

  <properties>
    <java.home>/path/to/jdk</java.home>
  </properties>
</profile>

 <activeProfiles>
   <activeProfile>myprofile</activeProfile>
 </activeProfiles>

Ответ или решение

Тема, связанная с отсутствием корректного распознавания JAVA_HOME командной строкой Maven, несмотря на правильно заданный путь к JDK, является достаточно распространенной среди разработчиков, работающих с Java и Maven. Несмотря на кажущуюся простоту настройки переменных среды, сложность этой задачи часто недооценивается. Рассмотрим теоретическую основу, примеры из вашего описания проблемы и предложим практические решения.

Теория

Переменная среды JAVA_HOME в операционной системе должна указывать на корневую директорию JDK. Почему именно JDK, а не JRE? JDK (Java Development Kit) включает в себя JRE (Java Runtime Environment) и ряд дополнительных инструментов, необходимых для компиляции, отладки и реализации Java-приложений. Maven, как инструмент управления сборкой, полагается на инструменты, содержащиеся в JDK, для выполнения своих задач, включая компиляцию исходного кода и выполнение тестов.

Если JAVA_HOME указывает на JRE, некоторые из этих возможностей могут быть недоступны, что влечет за собой проблемы в работе Maven. Однако, как вы заметили, бывают ситуации, когда Maven корректно отображает версию Java даже при указании JAVA_HOME на JRE. Это может быть связано с различными факторами, включая кэширование настроек или ранее установленных компонентов Maven.

Пример

Из вашего описания видно, что несмотря на корректное указание JAVA_HOME на JDK, вы столкнулись с ошибкой, что переменная не определена корректно. Это выглядит так:

C:\Users\{usr}>mvn -version
The JAVA_HOME environment variable is not defined correctly
This environment variable is needed to run this program
NB: JAVA_HOME should point to a JDK not a JRE

C:\Users\{usr}>echo %JAVA_HOME%
C:\Program Files\Java\jdk1.8.0_191

Вы также указали, что при установке JAVA_HOME на путь к JRE, Maven начал корректно отображать информацию о системе:

Apache Maven 3.6.1 (d66c9c0b3152b2e69ee9bac180bb8fcc8e6af555; 2019-04-05T03:00:29+08:00)
Maven home: C:\Program Files\Maven\apache-maven-3.6.1\bin\..
Java version: 1.8.0_191, vendor: Oracle Corporation, runtime: C:\Program Files\Java\jre1.8.0_191
Default locale: en_PH, platform encoding: Cp1252

Применение

Чтобы решить эту проблему, рекомендуется пройти несколько шагов диагностики и настройки:

1. Подтверждение корректности JAVA_HOME: Убедитесь, что переменная среды JAVA_HOME действительно указывает на корневую папку JDK. Если вы используете Windows, это можно проверить с помощью команды echo %JAVA_HOME%. На Linux-подобных системах используйте echo $JAVA_HOME.

2. Проверка системного пути: Убедитесь, что PATH системной переменной содержит путь %JAVA_HOME%\bin сразу после установки JAVA_HOME. Это гарантирует, что система сможет найти исполняемые файлы Java, такие как javac.

3. Очистка и тестировка переменных среды: Перезапустите командную строку и убедитесь, что изменения переменных среды учитываются. В Windows это можно сделать, открыв новое окно командной строки.

4. Настройки в конфигурационных файлах Maven: Как вы упомянули, решение проблемы удалось путем изменения settings.xml в конфигурации Maven. Включение профиля с указанием java.home в явной форме помогло некоторым пользователям:

   <profile>
    <id>myprofile</id>
    <activation>
      <jdk>1.8</jdk>
    </activation>
    <properties>
      <java.home>C:/Program Files/Java/jdk1.8.0_191</java.home>
    </properties>
   </profile>
   <activeProfiles>
    <activeProfile>myprofile</activeProfile>
   </activeProfiles>

   Такое решение может быть необходимо, если существующая конфигурация или другое ПО непреднамеренно меняет контекст выполнения Maven.

5. Перезапуск системы: Хотя это может звучать тривиально, иногда простое перезагрузка системы может помочь применить все изменения переменных окружения, особенно в Windows.

6. Проверка консистентности JDK и JRE: Убедитесь, что версии JDK и JRE совпадают. Иногда разные версии могут вызвать некорректную работу, если пути пересекаются.

7. Поиск конфликта с другими инструментами: Если на системе установлены разные инструменты разработки, такие как IDEs, они могут повлиять на переменные окружения.

Заключение

Корректная настройка Maven и переменной окружения JAVA_HOME играет ключевую роль в беспроблемной работе проектов на Java. Хотя иногда проблема может быть тривиальной и связанной с человеческим фактором, все равно важно пройти по каждому шагу диагностики, чтобы убедиться в отсутствии скрытых ошибок. Надеюсь, эти шаги помогут вам устранить возникшие проблемы и настроить систему для успешной работы.