Что такое Maven SNAPSHOT и зачем он нужен в Java-проектах?

Что такое SNAPSHOT в Maven?

SNAPSHOT (с англ. "моментальный снимок") — это специальная версия зависимости, которая обозначает, что артефакт находится в активной разработке. В отличие от релизных версий (например, 1.0.0), которые после публикации никогда не меняются, SNAPSHOT-версия может многократно перезаписываться одним и тем же номером.

Основная цель SNAPSHOT — упростить совместную разработку, когда команда постоянно вносит изменения в библиотеку, а другие проекты должны сразу их получать. Без SNAPSHOT вам пришлось бы каждое изменение публиковать как новую релизную версию (1.0.1, 1.0.2, ...), что быстро приведет к хаосу.

Как Maven обрабатывает SNAPSHOT?

По умолчанию Maven кэширует зависимости в локальном репозитории (~/.m2/repository). Для релизных версий он проверяет наличие артефакта локально и, если он уже есть, не делает повторных запросов в удаленный репозиторий. Для SNAPSHOT — поведение иное:

• Ежедневная проверка: Maven по умолчанию раз в сутки (24 часа) проверяет, не появилась ли новая версия SNAPSHOT в удаленном репозитории.
• Принудительное обновление: Вы можете заставить Maven игнорировать кэш и скачать последнюю версию с помощью флага -U (update snapshots): mvn clean install -U.
• Локальная сборка: Если вы собираете SNAPSHOT-проект локально (mvn install), он всегда перезаписывает локальную копию.

Почему Maven ведет себя "непредсказуемо"?

Проблема, с которой вы столкнулись, скорее всего, связана с политикой обновления SNAPSHOT. По умолчанию Maven не проверяет удаленный репозиторий при каждой сборке. Если вы изменили библиотеку, опубликовали новую SNAPSHOT в удаленный репозиторий, а затем собираете основной проект — Maven может использовать старую локальную копию.

Пример настройки pom.xml для принудительного обновления SNAPSHOT:

<repositories>
    <repository>
        <id>my-snapshot-repo</id>
        <url>https://mycompany.com/artifactory/libs-snapshot-local</url>
        <snapshots>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy>  <!-- Всегда проверять -->
        </snapshots>
    </repository>
</repositories>

Параметры updatePolicy:

• always — проверять при каждой сборке (замедляет работу, но гарантирует свежесть).
• daily — раз в день (по умолчанию).
• interval:X — раз в X минут (например, interval:60).
• never — никогда не проверять (только локальный кэш).

Как правильно использовать SNAPSHOT?

1. Только для разработки: SNAPSHOT-зависимости не должны использоваться в релизных сборках. Перед релизом все SNAPSHOT должны быть заменены на конкретные релизные версии.
2. Настройте политику обновления: Для активной разработки используйте always или interval:10 (каждые 10 минут). Для стабильных веток — daily.
3. Используйте флаг -U: Если нужно гарантированно получить последнюю версию прямо сейчас, запускайте сборку с mvn clean install -U.
4. Локальная разработка: Если вы одновременно работаете над библиотекой и основным проектом, проще всего сначала собрать библиотеку (mvn install), а затем основной проект — локальный SNAPSHOT всегда будет свежим.

Пример проверки, какую версию Maven использует:

mvn dependency:resolve -Dverbose=true

Эта команда покажет, какие версии зависимостей были выбраны и откуда они взяты (локальный кэш или удаленный репозиторий).

Итог

SNAPSHOT — это мощный инструмент для непрерывной интеграции, но он требует понимания его механики. Главное правило: SNAPSHOT — это нестабильная версия, которая может меняться в любой момент. Используйте её осознанно, настройте политику обновления под ваш процесс разработки, и вы избавитесь от "непредсказуемого" поведения Maven.