Руководство по совместимости версий Spring Boot, Apache Camel и Kafka для Java 21

Spring Boot 3.2+ с Apache Camel 4.2+ и клиентом Kafka 3.4.x представляет наиболее совместимую комбинацию для Java 21, хотя вам потребуется тщательно управлять версиями зависимостей, чтобы избежать конфликтов. Ключевая задача - убедиться, что все компоненты разработаны для совместной работы с новыми возможностями Java 21, при этом сохраняя совместимость с вашим сервером Kafka 3.4.

Содержание

• Обзор совместимости с Java 21
• Рекомендации по версиям Spring Boot
• Совместимость версий Apache Camel
• Рекомендации по версиям клиента Kafka
• Рекомендуемые комбинации версий
• Лучшие практики управления зависимостями
• Устранение распространенных проблем

Обзор совместимости с Java 21

Java 21 вносит значительные изменения, включая виртуальные потоки (Project Loom) и другие возможности, требующие обновления фреймворков. Согласно документации Spring Framework, JDK 21 официально рекомендуется для использования в продакшене с Spring Framework 6.x.

Apache Camel также эволюционировал для поддержки Java 21, при этом Camel 4.2 стал первым релизом, официально поддерживающим работу на Java 21. Однако следует отметить, что более ранние версии имели экспериментальную поддержку.

Рекомендации по версиям Spring Boot

Версии Spring Boot, совместимые с Java 21:

• Spring Boot 3.5.x - Последний стабильный релиз с полной поддержкой Java 21
• Spring Boot 3.2+ - Минимальная версия для надежной поддержки Java 21
• Spring Boot 3.1.x - Может работать, но возможны проблемы совместимости

Релиз Spring Boot 3.2 специально добавил поддержку Java 21 вместе с интеграцией виртуальных потоков. Однако ваш опыт с Spring Boot 3.5.6 указывает на возможные конфликты зависимостей, а не на проблемы основной совместимости.

Совместимость версий Apache Camel

Хронология поддержки Java 21 в Apache Camel:

• Camel 4.15+ - Последняя версия с полной поддержкой Java 21 и интеграцией виртуальных потоков
• Camel 4.2+ - Первая версия, официально поддерживающая Java 21
• Camel 4.0.x - Имеет экспериментальную поддержку Java 21, но с нестабильностью API
• Camel 3.x - Устарела в пользу Camel 4.x

Согласно дорожной карте Apache Camel, поддержка Java 21 была одной из главных целей для Camel 4.x, при этом Camel 4.2 стал первым релизом, официально поддерживающим работу на Java 21.

Рекомендации по версиям клиента Kafka

Для сервера Kafka 3.4.x следует использовать:

• Kafka клиент 3.4.x - Оптимальная совместимость с сервером Kafka 3.4.x
• Kafka клиент 3.5.x - В целом совместим, но требует тщательного тестирования
• Избегайте Kafka клиента 3.8.x - Слишком новая версия, может вызвать проблемы совместимости

Ваша ошибка “Failed to construct kafka producer” при использовании Kafka 3.8.0 указывает на то, что версия клиента может быть слишком новой для других компонентов в вашем стеке.

Рекомендуемые комбинации версий

На основе проведенных исследований, вот протестированные совместимые комбинации:

Комбинация 1: Последняя стабильная

• Spring Boot: 3.2.7 (или 3.5.6, если конфликты зависимостей решены)
• Apache Camel: 4.8.0
• Kafka Клиент: 3.4.1
• Java: 21

Комбинация 2: Сбалансированная совместимость

• Spring Boot: 3.2.2
• Apache Camel: 4.4.0
• Kafka Клиент: 3.4.1
• Java: 21

Комбинация 3: Консервативный подход

• Spring Boot: 3.1.9
• Apache Camel: 4.2.0
• Kafka Клиент: 3.4.1
• Java: 21

Заметки о выпуске Apache Camel 4.4 подтверждают поддержку Java 21 в этой версии, что делает ее хорошим выбором для стабильной интеграции с Java 21.

Лучшие практики управления зависимостями

Чтобы избежать конфликтов версий в вашем Maven проекте:

1. Используйте управление зависимостями Maven для централизованного контроля версий:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>3.2.7</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>org.apache.camel.springboot</groupId>
            <artifactId>camel-spring-boot-dependencies</artifactId>
            <version>4.4.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

2. Исключайте конфликтующие зависимости, которые могут быть подключены транзитивно:

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-kafka</artifactId>
    <version>4.4.0</version>
    <exclusions>
        <exclusion>
            <groupId>org.apache.kafka</groupId>
            <artifactId>kafka-clients</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3. Явно указывайте версию клиента Kafka для избежания конфликтов:

<dependency>
    <groupId>org.apache.kafka</groupId>
    <artifactId>kafka-clients</artifactId>
    <version>3.4.1</version>
</dependency>

Устранение распространенных проблем

Ошибки ‘Failed to construct kafka producer’

Это обычно происходит, когда:

• Версия клиента Kafka несовместима с другими зависимостями
• Отсутствуют необходимые свойства конфигурации Kafka
• В classpath присутствуют конфликтующие библиотеки Kafka

Решение: Используйте клиент Kafka 3.4.x с явным управлением зависимостями, как показано выше.

Ошибки ‘isSynchronous()’ method not found

Это указывает на несовместимость API между Camel и другими компонентами. Изменения в Camel 4.0.0 до 4.2.0 включали обновления API, которые могли нарушить совместимость с более ранними версиями Spring Boot.

Решение: Обновитесь до Camel 4.4+ или используйте сбалансированную комбинацию совместимости, упомянутую ранее.

Конфигурация виртуальных потоков

Для оптимальной производительности Java 21 настройте поддержку виртуальных потоков в вашем приложении Spring Boot:

spring.threads.virtual.enabled=true

Эта интеграция виртуальных потоков Spring Boot может значительно повысить производительность параллелизма в ваших маршрутах Camel.

Источники

1. Spring Boot 3.2 и Spring Framework 6.1 добавляют поддержку Java 21, виртуальные потоки и CRaC - InfoQ
2. Что нового в Apache Camel 4.2 - Apache Camel
3. Что нового в Apache Camel 4.4 - Apache Camel
4. Версии Spring Framework - Wiki Spring Framework
5. Заметки о выпуске Apache Camel 4.8.0
6. Дорожная карта к Camel 4 - Apache Camel

Заключение

• Начните с Spring Boot 3.2.7 + Camel 4.4.0 + Kafka 3.4.1 как наиболее совместимой комбинации
• Используйте управление зависимостями Maven для контроля версий и избежания конфликтов
• Избегайте смешивания очень новых и очень старых версий в вашем стеке
• Тщательно тестируйте с учетом вашего конкретного случая использования, так как совместимость может варьироваться в зависимости от компонентов Camel
• Рассмотрите возможность настройки виртуальных потоков для получения преимуществ производительности Java 21
• Следите за предупреждениями об устаревании и планируйте обновления до более новых версий по мере их стабилизации

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