Что делать, если появляется ошибка о ненахождении команды Maven

Ошибка ненахождения команды Maven: Диагностика и решение

Ошибка "command not found: mvn" или "mvn не распознана как внутренняя или внешняя команда" означает, что Maven не установлен или не добавлен в переменную окружения PATH. Рассмотрим все способы решения этой проблемы.

Шаг 1: Проверьте, установлен ли Maven

Откройте терминал и введите:

// В Linux/Mac:
mvn -version

// В Windows (Command Prompt или PowerShell):
mvn -version

Если Maven установлен, вы увидите версию. Если нет — переходим к установке.

Шаг 2: Установка Maven

Для Linux/Mac

Вариант 1: Через пакетный менеджер

# Ubuntu/Debian
sudo apt update
sudo apt install maven

# macOS (с Homebrew)
brew install maven

Вариант 2: Ручная установка

1. Скачайте Maven с официального сайта: https://maven.apache.org/download.cgi
2. Распакуйте архив в удобное место, например /opt/maven:

sudo tar -xzf apache-maven-3.9.x-bin.tar.gz -C /opt/

1. Добавьте Maven в PATH, отредактировав ~/.bashrc или ~/.zshrc:

export M2_HOME=/opt/apache-maven-3.9.x
export PATH=\"$M2_HOME/bin:$PATH\"

1. Примените изменения:

source ~/.bashrc  # или source ~/.zshrc для zsh

Для Windows

Вариант 1: Через Chocolatey (если установлен)

choco install maven

Вариант 2: Ручная установка

1. Скачайте Maven: https://maven.apache.org/download.cgi
2. Распакуйте в папку, например C:\\Program Files\\apache-maven-3.9.x
3. Добавьте путь в переменные окружения (Environment Variables):
   • Откройте System Properties (Win+Pause или Control Panel)
   • Нажмите Environment Variables
   • В System variables нажмите New
   • Variable name: M2_HOME
   • Variable value: C:\\Program Files\\apache-maven-3.9.x
4. Отредактируйте переменную PATH:
   • Добавьте: %M2_HOME%\\bin
5. Перезагрузите компьютер или откройте новый терминал

Шаг 3: Проверьте PATH

Если Maven установлен, но всё ещё не работает, проверьте PATH:

# Linux/Mac
echo $PATH

# Windows (PowerShell)
$env:Path

Проверьте, есть ли там путь к Maven. Если нет — добавьте его вручную (см. выше).

Шаг 4: Проверьте переменную окружения JAVA_HOME

Maven требует установленной Java. Убедитесь, что JAVA_HOME правильно установлена:

# Linux/Mac
echo $JAVA_HOME

# Windows (PowerShell)
$env:JAVA_HOME

Если пусто, установите:

# Linux/Mac: добавьте в ~/.bashrc
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64

# Windows: в Environment Variables
# Variable name: JAVA_HOME
# Variable value: C:\\Program Files\\Java\\jdk-17.0.x

Шаг 5: Используйте Maven Wrapper (mvnw)

Это лучшее решение — в проекте уже есть нужная версия Maven:

# Linux/Mac
./mvnw clean install

# Windows
mvnw.cmd clean install

Преимущества Maven Wrapper:

• Не нужно устанавливать Maven глобально
• Гарантирует одинаковую версию на всех машинах
• Автоматически скачивает нужную версию

Шаг 6: Проверка успешной установки

После всех действий проверьте:

mvn --version

Вывод должен быть похож на:

Apache Maven 3.9.6
Maven home: /opt/apache-maven-3.9.6
Java version: 17.0.1, vendor: Oracle Corporation
Java home: /usr/lib/jvm/java-17-openjdk

Шаг 7: Если ничего не помогло

Переустановите Maven:

1. Удалите старую версию:

# Linux/Mac
sudo rm -rf /opt/apache-maven-*
brew uninstall maven  # если через Homebrew

# Windows: удалите папку вручную

1. Очистите PATH от старых ссылок на Maven
2. Установите заново (см. Шаг 2)
3. Перезагрузите терминал или компьютер

Типичные ошибки

Рекомендации

1. Используйте Maven Wrapper (mvnw) в проектах — это избавляет от проблем
2. Проверяйте PATH — большинство ошибок из-за неправильной переменной окружения
3. Используйте IDE (IntelliJ IDEA, Eclipse) — они часто решают эти проблемы автоматически
4. Обновляйте Maven — старые версии могут быть несовместимы с новыми проектами

Вывод: Ошибка ненахождения Maven почти всегда решается либо установкой Maven, либо добавлением его в PATH. Maven Wrapper — самый надёжный способ избежать таких проблем в будущем.