Spring Boot与Kafka集成实践：从入门到实战

news2025/5/25 5:52:34

Spring Boot与Kafka集成实践

引言

在现代分布式系统中，消息队列技术扮演着至关重要的角色。Kafka作为一款高性能、高吞吐量的分布式消息队列系统，被广泛应用于日志收集、流处理、事件驱动架构等场景。本文将详细介绍如何在Spring Boot项目中集成Kafka，并通过实际代码示例展示其核心功能。

环境准备

在开始之前，请确保以下环境已就绪：

JDK 8或更高版本
Maven或Gradle构建工具
Kafka服务（本地或远程）
Spring Boot 2.5.x或更高版本

项目搭建

创建Spring Boot项目

使用Spring Initializr（https://start.spring.io/）创建一个新的Spring Boot项目，添加以下依赖：
- Spring for Apache Kafka
- Lombok（可选，用于简化代码）

配置Kafka

在application.properties或application.yml中配置Kafka相关参数：

spring.kafka.bootstrap-servers=localhost:9092
spring.kafka.consumer.group-id=my-group
spring.kafka.consumer.auto-offset-reset=earliest

生产者实现

以下是一个简单的Kafka生产者实现：

@RestController
public class KafkaProducerController {

    @Autowired
    private KafkaTemplate<String, String> kafkaTemplate;

    @PostMapping("/send")
    public String sendMessage(@RequestParam String message) {
        kafkaTemplate.send("my-topic", message);
        return "Message sent: " + message;
    }
}

消费者实现

以下是一个简单的Kafka消费者实现：

@Service
public class KafkaConsumerService {

    @KafkaListener(topics = "my-topic", groupId = "my-group")
    public void listen(String message) {
        System.out.println("Received Message: " + message);
    }
}

高级功能

消息序列化与反序列化

Kafka支持多种消息格式（如JSON、Avro等）。以下是一个使用JSON序列化的示例：

@Configuration
public class KafkaConfig {

    @Bean
    public ProducerFactory<String, Object> producerFactory() {
        Map<String, Object> config = new HashMap<>();
        config.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, "localhost:9092");
        config.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, StringSerializer.class);
        config.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, JsonSerializer.class);
        return new DefaultKafkaProducerFactory<>(config);
    }

    @Bean
    public KafkaTemplate<String, Object> kafkaTemplate() {
        return new KafkaTemplate<>(producerFactory());
    }
}

错误处理

Kafka提供了多种错误处理机制，例如通过@KafkaListener的errorHandler属性指定错误处理器：

@Service
public class KafkaConsumerService {

    @KafkaListener(topics = "my-topic", groupId = "my-group", errorHandler = "myErrorHandler")
    public void listen(String message) {
        // 业务逻辑
    }
}