개발 일상 | 백엔드 김승원의 실무 노트

들어가며"매일 새벽 3시에 100만 건의 CSV 데이터를 DB에 적재해야 합니다." 백엔드 개발자라면 한 번쯤은 이런 요구사항을 받아본 적이 있을 것입니다. 단순히 for문으로 insert를 돌리면 메모리 초과, 트랜잭션 타임아웃, 중간 실패 시 재처리 등 끝없는 문제가 발생합니다. 이런 대용량 데이터 처리를 안정적으로, 그리고 체계적으로 해결하기 위해 등장한 것이 바로 Spring Batch입니다.Spring Batch는 수년간 엔터프라이즈 환경에서 검증된 배치 프레임워크로, Job/Step/Chunk라는 명확한 아키텍처 위에 재시도, 스킵, 파티셔닝 같은 견고한 기능을 제공합니다. 이 글에서는 Spring Batch 5(Spring Boot 3.x 기반)의 핵심 개념부터 100만 건 CSV 가져오기 ..

들어가며얼마 전 운영팀에서 연락이 왔습니다. "결제 서비스가 느려진 것 같은데, 정확히 어떤 API가 어느 시점부터 느려졌는지 확인 가능해요?" 그런데 그 서비스에는 /actuator/health만 겨우 뚫려 있었습니다. Prometheus 연동도, 커스텀 메트릭도 없었습니다. 결국 로그를 긁어서 grep 돌리고, 엑셀에 붙여넣어 평균 응답 시간을 계산하는 데 퇴근 시간을 몽땅 썼습니다.3~7년차 백엔드 개발자라면 이런 경험이 낯설지 않을 것입니다. Spring Boot 프로젝트를 새로 만들 때 Actuator 의존성은 거의 반사적으로 추가하지만, 정작 health와 info 외에는 잘 쓰지 않는 경우가 많습니다. 그러다 장애가 터지면 "그때 메트릭 좀 더 붙여둘걸"이라는 후회가 밀려옵니다. 커스텀 He..

들어가며Spring Boot 4.0이 2025년 11월에 정식 출시되었습니다. Spring Framework 7 기반으로 구축된 이번 메이저 버전은 Virtual Threads 기본 실행 모델, Spring AI 통합, JSpecify 기반 null safety 등 패러다임 수준의 변화를 포함합니다. 이 글에서는 Spring Boot 3.x에서 4.0으로 마이그레이션하는 과정을 단계별로 안내합니다.1. Spring Boot 4.0 핵심 변경사항항목Spring Boot 3.xSpring Boot 4.0Spring Framework6.x7.x최소 Java 버전Java 17Java 21스레드 모델Platform Threads (기본)Virtual Threads (기본)Null SafetySpring @Null..

들어가며전통적인 Spring MVC는 요청당 하나의 스레드를 할당하는 블로킹 방식으로 동작합니다. 대부분의 서비스에서는 이 모델이 충분하지만, 동시 접속자가 매우 많거나 외부 API 호출이 빈번한 환경에서는 스레드 풀이 고갈되는 문제가 발생합니다. Spring WebFlux는 논블로킹 리액티브 방식으로 이 문제를 해결합니다. 이 글에서는 리액티브 프로그래밍의 핵심 개념부터 WebFlux 실전 코드까지 단계적으로 살펴보겠습니다.1. 리액티브 프로그래밍이란리액티브 프로그래밍은 데이터 스트림과 변화의 전파를 중심으로 하는 비동기 프로그래밍 패러다임입니다. Reactive Streams 사양은 다음 4가지 인터페이스를 정의합니다.Publisher - 데이터를 생성하고 발행Subscriber - 데이터를 구독하고..

들어가며Spring Security는 스프링 기반 애플리케이션의 인증(Authentication)과 인가(Authorization)를 담당하는 핵심 프레임워크입니다. Spring Security 6부터는 기존의 WebSecurityConfigurerAdapter가 완전히 제거되고, 컴포넌트 기반의 SecurityFilterChain으로 전환되었습니다. 이번 글에서는 Spring Security 6 환경에서 JWT 토큰 인증과 OAuth2 리소스 서버 설정을 실무 수준으로 다루겠습니다.1. Spring Security 6 주요 변경점Spring Security 6(Spring Boot 3.x 이상)에서 달라진 핵심 사항을 정리합니다.Before: WebSecurityConfigurerAdapter 방식 (..

Java 생태계, AI 시대에 어떻게 대응하고 있나2025년 11월 Spring Boot 4가 정식 출시되었고, Spring AI 2.0은 2026년 중반 GA를 목표로 빠르게 성숙하고 있습니다. Java 진영이 AI 통합을 어떻게 풀어가고 있는지, 두 프로젝트의 핵심 변화와 실무 적용 전략을 정리합니다.1. Spring Boot 4 주요 변경점Spring Boot 4는 단순한 버전 업이 아니라, Java 플랫폼의 현대화를 반영한 구조적 전환입니다.Jakarta EE 11 기반Spring Boot 4는 Jakarta EE 11을 기반으로 합니다. Jakarta EE 10에서 시작된 javax에서 jakarta로의 네임스페이스 전환이 완전히 정착된 상태이며, 새로운 API 표준들이 추가되었습니다. 기존 S..

들어가며테스트는 소프트웨어 품질을 보장하는 가장 확실한 방법입니다. 하지만 무작정 테스트를 작성하면 오히려 유지보수 비용만 증가합니다. 어떤 계층에서 어떤 종류의 테스트를 작성해야 하는지, 적절한 도구를 어떻게 활용하는지 아는 것이 중요합니다. 이 글에서는 JUnit 5, Mockito, Spring Boot Test의 다양한 슬라이스 테스트, 그리고 Testcontainers를 활용한 실전 테스트 전략을 다룹니다.1. 테스트 피라미드효과적인 테스트 전략은 테스트 피라미드를 따릅니다. / E2E \ ← 적게, 느리지만 확실한 검증 /----------\ / Integration \ ← 중간, 컴포넌트 간 상호작용 검증 /-----..

AOP(Aspect-Oriented Programming)란?AOP는 관점 지향 프로그래밍으로, 핵심 비즈니스 로직과 횡단 관심사(Cross-Cutting Concerns)를 분리하는 프로그래밍 패러다임입니다. 로깅, 트랜잭션 관리, 보안 검사, 성능 측정 등은 여러 모듈에 걸쳐 반복적으로 나타나는 공통 관심사인데, AOP를 사용하면 이를 깔끔하게 모듈화할 수 있습니다.AOP 핵심 용어용어설명Aspect횡단 관심사를 모듈화한 클래스. @Aspect로 선언Join PointAspect가 적용될 수 있는 지점 (메서드 실행, 필드 접근 등)AdviceJoin Point에서 실행되는 코드. @Before, @After, @Around 등PointcutAdvice가 적용될 Join Point를 선별하는 표현식W..

Spring Boot 예외 처리, 왜 전략이 필요한가?실무에서 Spring Boot 애플리케이션을 개발하다 보면 예외 처리는 피할 수 없는 핵심 관심사입니다. 단순히 try-catch로 예외를 잡는 것을 넘어, 클라이언트에게 일관된 에러 응답을 제공하고, 유지보수가 용이한 구조를 갖추는 것이 중요합니다. 이 글에서는 Spring Boot에서 제공하는 다양한 예외 처리 메커니즘을 살펴보고, 실무에서 바로 적용할 수 있는 에러 핸들링 아키텍처를 구축해보겠습니다.1. 기본적인 예외 처리 - @ExceptionHandler@ExceptionHandler는 특정 컨트롤러 내에서 발생하는 예외를 처리하는 가장 기본적인 방법입니다. 해당 컨트롤러 클래스 안에 선언하면, 그 컨트롤러에서 발생하는 지정된 예외를 잡아서 ..

들어가며Spring Boot 3.x가 릴리즈된 지 꽤 시간이 지났지만, 아직도 2.x 버전에서 운영 중인 프로젝트가 많습니다. 저 역시 실무에서 마이그레이션을 진행하면서 예상치 못한 부분에서 빌드가 깨지고, 런타임 에러가 터지는 경험을 했습니다. 이 글에서는 Spring Boot 3.x로 넘어갈 때 반드시 알아야 할 핵심 변경사항들을 정리합니다. 단순한 나열이 아니라, 실무에서 실제로 부딪히는 포인트 위주로 다루겠습니다.1. Jakarta EE 전환 — javax에서 jakarta로Spring Boot 3.x에서 가장 광범위하게 영향을 미치는 변경사항입니다. Java EE가 Eclipse Foundation으로 이관되면서 패키지 네임스페이스가 javax.*에서 jakarta.*로 변경되었고, Spring..