Что такое Maven: назначение, преимущества и недостатки

Скрипт build.bat собирает проект на Windows командой javac -cp "lib/gson.jar;lib/slf4j-api.jar" -d out src/com/example/*.java. Тот же скрипт, скопированный в build.sh на Linux, падает с error: package com.google.gson does not exist: в Linux элементы classpath разделяются двоеточием, а не точкой с запятой. Maven убирает такие проблемы целиком: один файл pom.xml и одна команда mvn package работают одинаково в любой операционной системе.

Maven (Apache Maven) — это инструмент для сборки Java-проектов и управления их зависимостями. Он скачивает нужные библиотеки, компилирует код, запускает тесты, упаковывает результат в jar или war и генерирует документацию. Проект описывается декларативно в файле pom.xml: вы указываете, что нужно получить, а как это сделать, Maven знает сам благодаря стандартным соглашениям.

Что такое Maven простыми словами

Простыми словами, Maven — это «автоматический сборщик» Java-проекта: вы один раз описываете проект и его библиотеки в pom.xml, а дальше любая команда вроде mvn package сама скачает зависимости, скомпилирует код, прогонит тесты и соберёт готовый jar. Ручные скрипты и папка lib с jar-файлами больше не нужны.

Maven разрабатывается фондом Apache Software Foundation, написан на Java и распространяется под лицензией Apache License 2.0. Первая версия вышла в 2004 году. Название взято из идиша и означает «знаток, собиратель знаний».

Без инструмента сборки маленький проект можно собрать вручную через javac и jar. Но с ростом проекта команда сборки становится очень длинной, её записывают в bat/sh-скрипт, а такие скрипты зависят от платформы, их нужно поддерживать вручную и копировать между проектами. Maven решает эту задачу по-другому: вместо описания шагов сборки он опирается на принцип convention over configuration («соглашения важнее конфигурации»). Если код лежит в стандартных каталогах, настраивать почти ничего не нужно:

my-app/
├── pom.xml                 # описание проекта
├── src/
│   ├── main/
│   │   ├── java/           # исходный код
│   │   └── resources/      # ресурсы (properties, xml, ...)
│   └── test/
│       └── java/           # тесты
└── target/                 # результат сборки (создаёт Maven)

Какие задачи решает Maven

Maven закрывает весь путь от исходного кода до готового артефакта: скачивание библиотек, компиляция, запуск тестов, упаковка в jar/war, установка в локальный репозиторий, публикация и генерация отчётов. Всё это запускается одной командой и одинаково выполняется на компьютере разработчика и на CI-сервере.

• Управление зависимостями — библиотеки и их собственные зависимости скачиваются автоматически по координатам из pom.xml.
• Единый процесс сборки — этапы сборки стандартизированы, поэтому mvn test или mvn package работают в любом Maven-проекте.
• Стандартная структура проекта — разработчик, впервые открывший чужой Maven-проект, сразу знает, где лежат код, ресурсы и тесты.
• Автоматизация на сервере — Jenkins, GitHub Actions, GitLab CI запускают ту же команду, что и разработчик.
• Отчёты и проверки качества — документация Javadoc, покрытие тестами, статический анализ подключаются плагинами.
• Многомодульные проекты — один родительский pom.xml собирает несколько связанных модулей в правильном порядке.

Ключевые понятия Maven

Чтобы работать с Maven, достаточно семи понятий: POM, артефакт, GAV-координаты, репозиторий, зависимость, жизненный цикл и плагин. Ниже каждое объяснено в одну строку, а подробный разбор — в отдельных уроках модуля, ссылки на них приведены в таблице.

Важная деталь архитектуры: сам Maven почти ничего не умеет. Компиляцию выполняет maven-compiler-plugin, тесты — maven-surefire-plugin, упаковку — maven-jar-plugin. Maven лишь знает, какой плагин вызвать на какой фазе.

Минимальный pom.xml и первая сборка

Минимальный рабочий pom.xml содержит версию модели POM и GAV-координаты проекта; версию Java задаёт свойство maven.compiler.release. Всё остальное — каталоги, тип упаковки jar, стандартные плагины — Maven берёт из встроенного родительского Super POM.

<project xmlns="http://maven.apache.org/POM/4.0.0">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.examclouds</groupId>
    <artifactId>hello-maven</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.release>21</maven.compiler.release>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
</project>

Если положить класс в src/main/java и выполнить в корне проекта команду сборки, Maven скомпилирует код, запустит тесты (если они есть) и создаст jar-файл:

mvn package

# Вывод (фрагмент):
[INFO] Building jar: /home/user/hello-maven/target/hello-maven-1.0-SNAPSHOT.jar
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------

Для Java 17 замените 21 на 17. Если установленный JDK старше указанной версии (например, JDK 17 при release 21), сборка остановится с ошибкой Fatal error compiling: error: release version 21 not supported. Что означают теги packaging, build, dependencies и суффикс -SNAPSHOT, разобрано в уроке Файл pom.xml в Maven.

Зависимости: что это и зачем

Зависимость в Maven — это сторонняя библиотека, которую проект использует и которую достаточно объявить в pom.xml по GAV-координатам. Maven сам скачает её из Maven Central в локальный репозиторий ~/.m2/repository и добавит в classpath при компиляции, тестах и упаковке.

<dependencies>
    <dependency>
        <groupId>com.google.code.gson</groupId>
        <artifactId>gson</artifactId>
        <version>2.11.0</version>
    </dependency>
</dependencies>

Вместе с библиотекой Maven подтягивает и её собственные зависимости — они называются транзитивными. Элемент <scope> уточняет, где библиотека нужна: по умолчанию (compile) — везде, а test — только для тестов. Полное дерево зависимостей проекта показывает команда:

mvn dependency:tree

Актуальные версии и Maven Wrapper

Актуальная стабильная ветка — Maven 3.9.x; для её запуска нужна Java 8 или новее, а версию Java для компиляции проекта задаёт pom.xml. Следующая мажорная версия, Maven 4, развивается параллельно; текущий статус и номер последнего релиза смотрите на странице загрузки Apache Maven.

Ещё два факта, которые часто расходятся со старыми статьями:

• С января 2020 года Maven Central принимает запросы только по HTTPS. Адрес вида http://repo1.maven.org/maven2 в старом pom.xml или settings.xml приводит к ошибке 501 HTTPS Required.
• Начиная с Maven 3.8.1 внешние репозитории по HTTP по умолчанию блокируются (встроенное зеркало maven-default-http-blocker).

Как установить Maven и проверить установку командой mvn -version, описано в уроке Руководство по установке Maven.

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

Главные преимущества Maven — независимость сборки от операционной системы, автоматическое управление зависимостями, единая структура проектов и огромная экосистема библиотек и плагинов. Именно поэтому Maven остаётся одним из двух стандартных инструментов сборки в мире Java наряду с Gradle.

1. Независимость от операционной системы. Сборка проекта выполняется в Windows, Linux и macOS по одному и тому же файлу pom.xml — без отдельных bat и sh-скриптов.
2. Управление зависимостями. Редкий проект пишется без сторонних библиотек, а те, в свою очередь, используют другие библиотеки разных версий. Maven строит полное дерево зависимостей и разрешает конфликты версий автоматически: если одна библиотека встречается несколько раз, выбирается версия, ближайшая к проекту в дереве (nearest wins). Это позволяет контролировать конфликты и при необходимости легко переходить на новые версии библиотек.
3. Сборка из командной строки. Одна команда (mvn package, mvn verify) запускает всю сборку — это нужно для автоматической сборки проекта на CI-сервере.
4. Хорошая интеграция со средами разработки. IntelliJ IDEA, Eclipse (плагин m2e) и VS Code (Extension Pack for Java) открывают pom.xml как проект: сами подтягивают зависимости, настраивают каталоги и запускают фазы сборки. Файлы настроек конкретной IDE хранить в репозитории не нужно.
5. Декларативное описание проекта (POM). В pom.xml описывается, что нужно получить, а не последовательность шагов. Описание легко читать и переносить между проектами.
6. Огромный, поддерживаемый в актуальном состоянии репозиторий артефактов. В Maven Central опубликованы практически все открытые Java-библиотеки; ими пользуются и Gradle, и другие инструменты сборки.
7. Модульная архитектура и огромное количество плагинов. Компиляция, тесты, упаковка, анализ кода, генерация документации и Docker-образов — всё подключается плагинами (подробнее — в уроке Использование плагинов в Maven).
8. Единые соглашения. Одинаковая структура каталогов и одинаковые команды во всех проектах снижают порог входа в новый проект.

Недостатки Maven

Основные недостатки Maven — сложность освоения, «неявное» поведение из-за соглашений по умолчанию, многословный XML и трудная диагностика ошибок. Кроме того, для нестандартной логики сборки Maven менее гибок, чем Gradle, а инкрементальная сборка у него медленнее.

1. Сложность освоения. Чтобы уверенно работать с Maven, нужно понимать жизненный цикл, плагины, область видимости зависимостей и наследование POM.
2. Неочевидность в некоторых моментах. Многое происходит «за кадром»: каждый pom.xml наследует настройки Super POM, а плагины привязаны к фазам по умолчанию. Увидеть итоговую конфигурацию помогает команда mvn help:effective-pom.
3. Огромное количество плагинов. Для одной задачи часто существует несколько плагинов разного качества и степени поддержки — трудно сориентироваться и выбрать.
4. Трудно разобраться, если что-то пошло не так. Сообщения об ошибках бывают длинными и неинформативными. Подробности дают флаги -e (стек исключения) и -X (отладочный вывод).
5. Нужен доступ в интернет или собственный репозиторий артефактов. Первая сборка скачивает зависимости и плагины. Офлайн-режим mvn -o работает, только если всё нужное уже лежит в локальном репозитории.
6. Многословный XML. Даже простая зависимость занимает 5 строк, а большой pom.xml легко разрастается до сотен строк.
7. Ограниченная гибкость. Нестандартные шаги сборки приходится реализовывать через плагины или писать собственный плагин, тогда как в Gradle логику можно описать прямо в скрипте сборки.

Maven, Ant или Gradle: сравнение

Ant, Maven и Gradle — три основных инструмента сборки для Java. Ant описывает шаги сборки вручную и не управляет зависимостями, Maven задаёт стандартный процесс и структуру через декларативный pom.xml, а Gradle сочетает соглашения Maven с гибкостью скриптов на Groovy или Kotlin и быстрой инкрементальной сборкой.

Когда выбирать Maven. Maven — хороший выбор, если проект укладывается в стандартный процесс «скомпилировать — протестировать — упаковать», важны предсказуемость и единообразие, а в команде разный уровень опыта. Gradle выигрывает в больших многомодульных проектах, где критична скорость сборки, и в Android-разработке. Новичку разумно начинать с Maven: его соглашения и терминологию (GAV, scope, репозитории) использует и Gradle.