실습 예제 on Advanced Beginner

환경 구성

d8lzz1gpw@mozmail.com (kimbenji) — Sat, 10 Jan 2026 00:00:00 +0000

Spring Boot에서 Kafka를 사용하기 위한 환경 설정 레퍼런스입니다.

TL;DR

Kafka 실행: Docker Compose로 KRaft 모드 Kafka 3.6.1 실행

의존성: spring-kafka, spring-boot-starter-web 추가

기본 설정: bootstrap-servers, Serializer/Deserializer, group-id 설정

프로덕션: acks: all, enable.idempotence: true로 안정성 확보

대상 독자 및 선수 지식#

항목	설명
대상 독자	Spring Boot 프로젝트에서 Kafka 환경을 구성하려는 개발자
선수 지식	Docker 기본 사용법, Gradle 또는 Maven 빌드 도구, Spring Boot 설정 파일(application.yml)
필수 도구	Docker Desktop 또는 Docker Engine, JDK 17+, IDE (IntelliJ IDEA 권장)
예상 소요 시간	약 15분

Quick Start를 완료했다면 이미 기본 환경을 구성한 것입니다. 이 문서는 설정 상세 내용과 프로덕션 환경 구성을 위한 참조 문서입니다.

Spring Kafka로 Producer/Consumer 구현하기

d8lzz1gpw@mozmail.com (kimbenji) — Sat, 10 Jan 2026 00:00:00 +0000

이 문서에서는 Spring Kafka를 사용하여 메시지를 송수신하는 방법을 단계별로 실습합니다.

TL;DR

Producer: KafkaTemplate으로 동기/비동기 메시지 전송, Key 사용으로 Partition 지정

Consumer: @KafkaListener로 메시지 수신, 배치 처리 및 패턴 구독 지원

수동 커밋: Acknowledgment로 처리 완료 후 명시적 커밋

에러 처리: @RetryableTopic으로 재시도 및 Dead Letter Topic 설정

시작하기 전에#

항목	요구사항
대상 독자	Spring Boot 애플리케이션에서 Kafka를 사용하려는 백엔드 개발자
선수 지식	Java 기본 문법, Spring Boot 기초, Kafka 기본 개념
사전 완료	Quick Start 예제 완료, 환경 구성 설정 완료
예상 소요 시간	약 30분

환경별 주의사항
Windows 사용자: 명령어에서 ./gradlew 대신 gradlew.bat을 사용하세요.

주문 시스템

d8lzz1gpw@mozmail.com (kimbenji) — Sat, 10 Jan 2026 00:00:00 +0000

실무에 가까운 이벤트 기반 주문 시스템을 구현합니다. 이 예제에서는 주문 생성부터 배송 완료까지의 전체 흐름을 Kafka 이벤트로 처리하며, Message Key를 활용한 순서 보장과 여러 Consumer Group을 활용한 확장 패턴을 학습합니다.

TL;DR

이벤트 기반 아키텍처: REST API 요청을 Kafka 이벤트로 변환하여 비동기 처리

Message Key: orderId를 Key로 사용하여 같은 주문 이벤트의 순서 보장

상태 머신: CREATED -> PAID -> SHIPPED -> DELIVERED 순서로 상태 전이

확장 패턴: 여러 Consumer Group이 동일 Topic 독립적으로 구독

대상 독자 및 선수 지식#

항목	설명
대상 독자	이벤트 기반 시스템을 구축하려는 백엔드 개발자
선수 지식	Spring Boot 기초, Kafka 기본 개념, 기본 예제 완료
필수 환경	Docker로 Kafka 실행 중, JDK 17+, Gradle
예상 소요 시간	약 45분

이 페이지의 모든 코드 예제에서는 다음 import가 공통으로 사용됩니다. Spring Kafka의 KafkaTemplate과 @KafkaListener를 중심으로 구현하며, Jackson ObjectMapper를 통해 JSON 직렬화를 처리합니다.

마이크로서비스 연동

d8lzz1gpw@mozmail.com (kimbenji) — Sat, 10 Jan 2026 00:00:00 +0000

마이크로서비스 환경에서 Kafka를 활용한 이벤트 기반 통신을 구현합니다.

TL;DR

이벤트 체이닝: 주문 -> 결제 -> 배송 -> 알림 순서로 이벤트 전파

Correlation ID: 분산 추적을 위한 상관 ID 전파

Saga 패턴: 보상 트랜잭션으로 분산 트랜잭션 처리

멱등성: 중복 메시지 안전하게 처리

대상 독자 및 선수 지식#

항목	설명
대상 독자	마이크로서비스 아키텍처에서 이벤트 기반 통신을 구축하려는 개발자
선수 지식	Kafka 기본, Spring Boot, 주문 시스템 예제 이해
필수 환경	Docker, JDK 17+, 여러 서비스를 실행할 수 있는 환경
예상 소요 시간	약 60분

시나리오: 주문 처리 시스템#

이 예제에서는 주문 서비스, 결제 서비스, 배송 서비스, 알림 서비스가 Kafka를 통해 이벤트를 주고받습니다. 주문 서비스가 주문을 생성하면 orders Topic에 이벤트를 발행합니다. 결제 서비스가 이를 수신하여 결제를 처리하고 payments Topic에 결과를 발행합니다. 배송 서비스는 결제 완료 이벤트를 수신하여 배송을 생성합니다. 알림 서비스는 모든 Topic을 구독하여 고객에게 알림을 발송합니다.