Жизненный цикл сборки Maven: фазы, цели плагинов и команды

Команда mvn clean jar:jar завершается BUILD SUCCESS, а в каталоге target появляется shop-1.0-SNAPSHOT.jar. Только классов в нём нет, а в логе стоит предупреждение JAR will be empty - no content was marked for inclusion!. Причина в том, что jar:jar — это цель плагина, а не фаза: Maven выполнил ровно её и не стал компилировать код. Команда mvn clean package дала бы рабочий jar, потому что фаза package тянет за собой все предыдущие этапы сборки.

Жизненный цикл сборки Maven (build lifecycle) — это заранее определённая упорядоченная последовательность фаз, через которые проходит проект: проверка, компиляция, тесты, упаковка, установка и публикация. В Maven три встроенных жизненных цикла: default (сборка), clean (очистка) и site (сайт проекта). Когда вы запускаете фазу, например mvn package, Maven выполняет все фазы этого цикла до неё включительно, а реальную работу на каждой фазе делают привязанные к ней цели (goals) плагинов.

Три жизненных цикла: default, clean, site

В Maven встроено три независимых жизненных цикла: default собирает проект от проверки POM до публикации артефакта, clean удаляет результаты прошлой сборки, site генерирует сайт проекта с отчётами. Фаза одного цикла не запускает фазы другого: mvn install не очищает target, а mvn clean ничего не компилирует.

Слово clean обозначает и сам жизненный цикл, и его главную фазу, отсюда путаница в старых статьях, где clean и site называют «фазами, стоящими особняком». Точнее так: это отдельные циклы, которые выполняются, только если их фаза явно указана в команде. Для mvn site используется maven-site-plugin, а какие отчёты попадут на сайт, задаёт раздел <reporting> в pom.xml.

В одной команде можно перечислить фазы разных циклов — Maven выполнит их слева направо:

mvn clean package site

Здесь сначала отработает цикл clean до фазы clean, затем default до package, затем site до site: проект собирается «с нуля» и получает сайт с документацией.

Фазы жизненного цикла default

Жизненный цикл default состоит из 23 фаз, но в командах обычно используют семь основных: validate, compile, test, package, verify, install и deploy. Остальные фазы — промежуточные точки, к которым плагины привязывают подготовительные шаги: генерацию кода, копирование ресурсов, запуск окружения для интеграционных тестов.

Полный порядок фаз default (Maven 3), основные выделены в таблице выше:

validate -> initialize
-> generate-sources -> process-sources -> generate-resources -> process-resources
-> compile -> process-classes
-> generate-test-sources -> process-test-sources -> generate-test-resources -> process-test-resources
-> test-compile -> process-test-classes -> test
-> prepare-package -> package
-> pre-integration-test -> integration-test -> post-integration-test
-> verify -> install -> deploy

Фазы с префиксами pre-, post- и process- напрямую почти никогда не вызывают: они нужны, чтобы плагин мог встроиться в правильное место сборки. Фаза, к которой не привязано ни одной цели, ничего не делает — например, для простого jar-проекта mvn validate только прочитает и проверит POM и выведет BUILD SUCCESS. Как install раскладывает файлы по каталогам локального репозитория, разобрано в уроке Виды репозиториев в Maven.

Запуск фазы выполняет все предыдущие

Главное правило жизненного цикла: команда mvn <phase> выполняет все фазы того же цикла от первой до указанной включительно. Поэтому mvn package сам скопирует ресурсы, скомпилирует код и прогонит тесты, а фазы после package (verify, install, deploy) не запустятся.

mvn package

В выводе Maven каждая выполненная цель отмечена строкой вида --- plugin:version:goal (execution-id) @ project ---, и по ним видно, что произошло на самом деле. Вывод (фрагмент, Maven 3.9; версии плагинов зависят от версии Maven):

[INFO] --- resources:3.3.1:resources (default-resources) @ shop ---
[INFO] --- compiler:3.13.0:compile (default-compile) @ shop ---
[INFO] --- resources:3.3.1:testResources (default-testResources) @ shop ---
[INFO] --- compiler:3.13.0:testCompile (default-testCompile) @ shop ---
[INFO] --- surefire:3.5.2:test (default-test) @ shop ---
[INFO] Tests run: 3, Failures: 0, Errors: 0, Skipped: 0
[INFO] --- jar:3.4.1:jar (default-jar) @ shop ---
[INFO] Building jar: /home/user/shop/target/shop-1.0-SNAPSHOT.jar
[INFO] BUILD SUCCESS

Фазы без привязанных целей (validate, initialize, generate-sources, prepare-package и другие) в логе не упоминаются: для jar-проекта на них ничего не выполняется. Префикс default- в скобках означает, что цель пришла из стандартной привязки, а не из вашего pom.xml. Если тест падает, Maven останавливается на фазе test, и jar не создаётся.

Команда mvn deploy пройдёт все фазы default, но в учебном проекте завершится ошибкой на последней: не указано, куда публиковать.

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-deploy-plugin:3.1.2:deploy (default-deploy) on project shop:
Deployment failed: repository element was not specified in the POM inside distributionManagement element
or in -DaltDeploymentRepository=id::url parameter

Фаза и цель (goal): в чём разница

Фаза — это шаг жизненного цикла, сама по себе она ничего не делает. Цель (goal) — конкретное действие плагина, например compiler:compile или jar:jar. При запуске фазы Maven выполняет все предыдущие фазы того же цикла и привязанные к ним цели. При запуске цели выполняется только она одна, без предыдущих шагов.

Короткая форма jar:jar — это префикс плагина и имя цели. Цели вызывают напрямую для разовых действий, которые не входят в сборку: mvn dependency:tree, mvn help:effective-pom, mvn versions:display-dependency-updates. Фазы и цели можно смешивать в одной команде: mvn clean compile dependency:tree выполнит цикл clean, затем default до compile и только потом цель dependency:tree.

Отсюда ошибка из начала урока: mvn clean jar:jar удалил target и сразу упаковал несуществующий каталог классов. Вывод:

[INFO] --- clean:3.2.0:clean (default-clean) @ shop ---
[INFO] Deleting /home/user/shop/target
[INFO] --- jar:3.4.1:jar (default-cli) @ shop ---
[WARNING] JAR will be empty - no content was marked for inclusion!
[INFO] Building jar: /home/user/shop/target/shop-1.0-SNAPSHOT.jar
[INFO] BUILD SUCCESS

Id выполнения default-cli показывает, что цель вызвана из командной строки, а не фазой. Чтобы собрать jar, запускайте фазу: mvn clean package.

Привязка целей плагинов к фазам

Какие цели выполняются на каждой фазе, определяет элемент <packaging> в pom.xml: для каждого типа упаковки в Maven встроен свой набор стандартных привязок (lifecycle mapping). Поэтому jar-проект собирается без единого объявленного плагина, а war и pom на тех же фазах делают другое. Свои цели можно привязать к любой фазе в разделе <build><plugins>.

Стандартные привязки для packaging = jar (Maven 3.9.x):

У war на фазе package вместо jar:jar выполняется war:war. У pom (родительские и агрегирующие POM) остаются только install и deploy: компиляции и тестов нет. Как значение packaging задаётся и на что ещё влияет, описано в разделе Элемент packaging, а как привязать к фазе свою цель через <executions> — в уроке Использование плагинов в Maven. Если к одной фазе привязано несколько целей, сначала выполняются цели из стандартной привязки, затем объявленные в pom.xml — в порядке объявления.

Таблица выше справедлива для «чистого» проекта. Проверить фактические привязки вашего проекта (с учётом родителя и версий плагинов) можно командой mvn help:describe:

mvn help:describe -Dcmd=compile

Вывод (фрагмент):

[INFO] 'compile' is a phase corresponding to this plugin:
org.apache.maven.plugins:maven-compiler-plugin:3.13.0:compile

It is a part of the lifecycle for the POM packaging 'jar'. This lifecycle includes the following phases:
* validate: Not defined
* initialize: Not defined
...
* process-resources: org.apache.maven.plugins:maven-resources-plugin:3.3.1:resources
* compile: org.apache.maven.plugins:maven-compiler-plugin:3.13.0:compile
...
* test: org.apache.maven.plugins:maven-surefire-plugin:3.5.2:test
* package: org.apache.maven.plugins:maven-jar-plugin:3.4.1:jar

Not defined означает, что к фазе ничего не привязано. Описание целей конкретного плагина выводит mvn help:describe -Dplugin=surefire -Ddetail. Официальный список фаз и привязок — в документации Introduction to the Build Lifecycle.

Unit- и интеграционные тесты: surefire и failsafe

Unit-тесты запускает maven-surefire-plugin на фазе test, он подключён по умолчанию. Интеграционные тесты запускает maven-failsafe-plugin: его нужно объявить в pom.xml. Он работает на фазах integration-test и verify, поэтому интеграционные тесты запускают командой mvn verify, а не mvn integration-test.

Интеграционные тесты выполняются после package, так как им часто нужен собранный артефакт и внешнее окружение: база данных, контейнер, поднятый сервер. Запуск окружения привязывают к pre-integration-test, остановку — к post-integration-test. Минимальное подключение failsafe:

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-failsafe-plugin</artifactId>
            <version>3.5.2</version>
            <executions>
                <execution>
                    <goals>
                        <goal>integration-test</goal>
                        <goal>verify</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

Элемент <phase> здесь не нужен: у целей failsafe есть фазы по умолчанию, совпадающие с их именами. Вывод mvn verify для проекта с классом OrderRepositoryIT (фрагмент):

[INFO] --- surefire:3.5.2:test (default-test) @ shop ---
[INFO] Tests run: 3, Failures: 0, Errors: 0, Skipped: 0
[INFO] --- jar:3.4.1:jar (default-jar) @ shop ---
[INFO] --- failsafe:3.5.2:integration-test (default) @ shop ---
[INFO] Running com.examclouds.shop.OrderRepositoryIT
[INFO] Tests run: 2, Failures: 0, Errors: 0, Skipped: 0
[INFO] --- failsafe:3.5.2:verify (default) @ shop ---
[INFO] BUILD SUCCESS

Подробности настройки — в документации Maven Failsafe Plugin. Где хранить тестовые классы и ресурсы, показано в разделе Структура Maven-проекта.

Основные команды сборки

В повседневной работе хватает нескольких команд: mvn clean verify — полная проверка проекта, mvn clean install — то же плюс установка в локальный репозиторий, -DskipTests — сборка без запуска тестов, -pl — сборка отдельных модулей многомодульного проекта.

mvn package -DskipTests

Вывод (фрагмент):

[INFO] --- surefire:3.5.2:test (default-test) @ shop ---
[INFO] Tests are skipped.
[INFO] --- jar:3.4.1:jar (default-jar) @ shop ---
[INFO] BUILD SUCCESS

Флаг -DskipTests предпочтительнее -Dmaven.test.skip=true: тестовый код хотя бы компилируется, и ошибка в нём не останется незамеченной. Кроме того, если другой модуль подключает ваши тестовые классы как test-jar, с maven.test.skip этот jar не будет создан, и сборка зависимого модуля упадёт на разрешении зависимости. Ключ -pl принимает путь к каталогу модуля или :artifactId, несколько модулей перечисляются через запятую.

Что меняется в Maven 4

В Maven 4 (на ноябрь 2026 года в стадии preview, рекомендуемой остаётся ветка 3.x) жизненный цикл совместим с Maven 3: те же фазы и команды mvn clean verify и mvn install. Главное изменение — вместо фаз pre-* и post-* появились хуки before: и after: для любой фазы (например, before:integration-test), а старые имена сохранены для совместимости.

Для учебных проектов на Maven 3.9.x и 3.10.x всё, что описано в уроке, работает без изменений. Какая версия Maven установлена, показывает mvn -version, а зафиксировать её для всей команды помогает Maven Wrapper (см. урок Что такое Maven).

На чём чаще всего спотыкаются

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