JSCODE Logo
JSCODE 박재성JSCODE 제이온JSCODE 시니
과외유튜브블로그후기
완강 후기 이벤트블로그 리뷰 이벤트AWS SAA 합격 후기 이벤트
회사명 : JSCODE대표 : 박재성사업자 등록번호 : 244-22-01557통신판매업 : 제 2023-인천미추홀-0381 호

서울특별시 구로구 경인로 20가길 11(오류동, 아델리아)

Copyright ⓒ 2026 JSCODE - 최상위 현업 개발자들의 프로그래밍 교육 All rights reserved.

이용약관개인정보처리방침

실전에서 바로 써먹는 Kafka 입문

Kafka 사전 지식 / 환경 셋팅

Kafka를 왜 배워야할까?
Kafka란? / 메시지 큐(Message Queue)란?
Kafka 설치할 환경 셋팅하기 (feat. EC2)
AWS EC2에 Kafka 설치/실행하기

Kafka 기본 개념

Kafka의 기본 구성 (Topic, Consumer, Producer)
토픽 생성하기 / 조회하기 / 삭제하기
Kafka에 메시지 넣기 / Kafka에서 메시지 조회하기
메시지를 어디까지 읽었는 지 기억하고, 그 다음 메시지부터 처리하기 (Consumer Group, Offset)
[보충 자료] 토픽, 컨슈머 그룹 이름 짓는 법 (Naming Convention)
[실습] Spring Boot에 Kafka 연결을 위한 코드 추가하기
[실습] Spring Boot로 Kafka에 메시지 넣는 코드 작성하기 (Producer)
[실습] Spring Boot가 Kafka에 메시지 잘 넣는 지 테스트해보기
[실습] Spring Boot로 Kafka에서 메시지 조회하기 (Consumer)
Kafka의 비동기 처리로 인한 성능 이점 느껴보기

Kafka 메시지 처리 실패 시 대처 방법

[실습] Spring Boot로 Kafka에서 처리에 실패한 메시지를 재시도(Retry)하도록 만들기
[실습] Spring Boot로 Kafka에서 재시도조차 실패한 메시지를 따로 보관하기 (DLT, Dead Letter Topic)
[실습] Spring Boot로 재시도조차 실패한 메시지 사후 처리하기

Kafka 메시지 처리 성능 높이기 (병렬 처리)

컨슈머가 메시지를 하나씩만 처리하는 현상
파티션(Partition)이란? / 특징
[실습] Spring Boot로 하나의 파티션에는 정말 하나의 컨슈머만 할당되는 지 확인해보기
특정 토픽의 파티션 수 조회하기 / 설정하기 / 변경하기
[실습] Spring Boot로 여러 개의 파티션에 메시지가 골고루 들어가는 지 확인해보기
[실습] Spring Boot에서 여러 개의 컨슈머로 메시지 병렬적으로 처리하기
[실습] Spring Boot에서 하나의 컨슈머로 메시지 병렬적으로 처리하기
적정 파티션 개수 계산하는 방법
컨슈머가 메시지를 지연 없이 잘 처리하고 있는 지 확인하는 방법 (Consumer Lag)

Kafka 장애 대비하기 (고가용성)

노드(node), 브로커(broker), 컨트롤러(controller), 클러스터(cluster), 레플리케이션(replication)이란?
[실습] kafka 서버 총 3대 셋팅하기
[실습] Kafka 서버 3대가 서로 잘 연동됐는 지 확인하기
토픽 세부 정보 출력값 정보 해석하기 (Isr, Leader, Replicas 등)
[실습] 팔로워 파티션에 메시지를 넣으면 어떻게 될까?
[실습] 리더 파티션에 장애가 발생하면 어떻게 될까? / Kafka 서버 1대가 고장나면 어떻게 될까?
Kafka 서버는 몇 대를 운용하는 게 좋을까?
Spring Boot에 Kafka 서버 3대를 연결해서 사용하는 방법

[프로젝트] MSA 프로젝트에서 Kafka 도입하기

프로젝트 설계
[실습] Spring Boot로 UserService 서버 초기 환경 설정하기
[실습] 회원가입 API 전체 뼈대 만들기
[실습] 회원 가입 비즈니스 로직 짜기
[실습] Spring Boot로 EmailService 서버 초기 환경 설정하기
[실습] 이메일 발송을 처리할 Consumer 로직 짜기
[실습] 프로젝트 구조에 맞게 Kafka 셋팅하기
[실습] 잘 작동하는 지 테스트해보기
← 블로그 목록으로 돌아가기

[실습] 회원 가입 비즈니스 로직 짜기

JSCODE 박재성
JSCODE 박재성
2026. 03. 13.
author
JSCODE 박재성
category
Kafka
createdAt
Dec 6, 2025 02:15 PM
isPublic
isPublic
series
실전에서 바로 써먹는 Kafka 입문
slug
practice-implement-signup-logic
type
post
updatedAt
Mar 13, 2026 09:00

✅ 회원 가입 비즈니스 로직 짜기

  1. 회원 가입한 사용자 정보 DB에 저장하기
    1. UserService
      @Service public class UserService { private final UserRepository userRepository; private final KafkaTemplate<String, String> kafkaTemplate; public UserService(UserRepository userRepository, KafkaTemplate<String, String> kafkaTemplate) { this.userRepository = userRepository; this.kafkaTemplate = kafkaTemplate; } public void signUp(SignUpRequestDto signUpRequestDto) { // 회원 가입한 사용자 정보 DB에 저장 User user = new User( signUpRequestDto.getEmail(), signUpRequestDto.getName(), signUpRequestDto.getPassword() ); userRepository.save(user); } }
       
  1. Kafka에 전송할 메시지 객체 만들기
    1. Kafka에 넣을 메시지 객체 이름을 UserSignedUpEvent라고 지을건데, 이렇게 이름을 짓는 이유는 MSA 구조에서 많이 사용하는 이벤트 기반 아키텍처에서 사용하는 네이밍 방식을 활용해 지은 것이다. 이 개념에 대해 모르는 분들은 그냥 ‘MSA에서 많이 사용하는 메시지 객체의 이름이구나’ 정도로만 인지하고 넘어가자.
       
      UserSignedUpEvent
      public class UserSignedUpEvent { private Long userId; private String email; private String name; public UserSignedUpEvent(Long userId, String email, String name) { this.userId = userId; this.email = email; this.name = name; } public Long getUserId() { return userId; } public String getEmail() { return email; } public String getName() { return name; } }
      UserSignedUpEvent 메시지 객체에 password 속성은 일부러 포함시키지 않았다. 왜냐하면 password 값을 다른 종류의 서버(ex. 이메일 서버)에서 활용할 일이 없기 때문이다. 다른 데서 활용할 일이 없는데 굳이 불필요한 정보를 포함시켜 kakfa에 메시지를 보낼 필요가 없다. 이와 같이 kafka에 메시지를 보낼 때는 필요한 정보만 선별해서 보내면 된다.
       
  1. Json 형태의 String으로 만들어 주는 함수 추가하기
    1. UserService
      @Service public class UserService { private final UserRepository userRepository; public UserService(UserRepository userRepository) { this.userRepository = userRepository; } public void signUp(SignUpRequestDto signUpRequestDto) { // 회원 가입한 사용자 정보 DB에 저장 User user = new User( signUpRequestDto.getEmail(), signUpRequestDto.getName(), signUpRequestDto.getPassword() ); userRepository.save(user); } private String toJsonString(Object object) { ObjectMapper objectMapper = new ObjectMapper(); try { String message = objectMapper.writeValueAsString(object); return message; } catch (JsonProcessingException e) { throw new RuntimeException("Json 직렬화 실패"); } } }
       
  1. Kafka에 메시지 보내는 로직 추가하기
    1. @Service public class UserService { private final UserRepository userRepository; private final KafkaTemplate<String, String> kafkaTemplate; public UserService(UserRepository userRepository, KafkaTemplate<String, String> kafkaTemplate) { this.userRepository = userRepository; this.kafkaTemplate = kafkaTemplate; } public void signUp(SignUpRequestDto signUpRequestDto) { // 회원 가입한 사용자 정보 DB에 저장 User user = new User( signUpRequestDto.getEmail(), signUpRequestDto.getName(), signUpRequestDto.getPassword() ); User savedUser = userRepository.save(user); // 카프카에 메시지 전송 UserSignedUpEvent userSignedUpEvent = new UserSignedUpEvent( savedUser.getId(), savedUser.getEmail(), savedUser.getName() ); this.kafkaTemplate.send("user.signed-up", toJsonString(userSignedUpEvent)); } private String toJsonString(Object object) { ObjectMapper objectMapper = new ObjectMapper(); try { String message = objectMapper.writeValueAsString(object); return message; } catch (JsonProcessingException e) { throw new RuntimeException("Json 직렬화 실패"); } } }
 
 

✅ 중간 체크

전체 프로젝트 구조에서 User Service에 해당하는 부분을 다 구현했다. 다음 강의에서는 Email Service에 해당하는 부분을 구현해보자.
notion image
📎
이 글은 실전에서 바로 써먹는 Kafka 입문 강의의 수업 자료 중 일부입니다.