当前位置：首页 > article >正文

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

article 2025/7/5 18:05:49

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 {@Autowiredprivate 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 {@Beanpublic 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);}@Beanpublic 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) {// 业务逻辑}
}