Spring Boot의 역할

Spring Framework는 객체를 만들고 연결하는 컨테이너와 웹 MVC 같은 핵심 기능을 제공합니다. 그러나 내장 웹 서버, 라이브러리 버전 조합, JSON 변환기, 설정 파일, 실행 JAR까지 개발자가 하나씩 연결하면 첫 프로젝트를 띄우기 전에 결정할 일이 많습니다.

Spring Boot는 Spring 애플리케이션을 빠르게 시작할 수 있도록 검증된 의존성 조합과 기본 설정을 제공하는 도구입니다. 스타터는 한 기능에 필요한 라이브러리를 묶고, 자동 구성은 클래스 경로·설정·사용자 빈을 보고 필요한 기본 빈을 등록합니다. Boot가 Spring을 대체하는 것은 아닙니다. Spring 위에서 반복 조립을 줄이고, 애플리케이션이 필요한 부분만 빈이나 속성으로 바꾸게 합니다.

반복 조립 문제

내장 서버를 만들고 포트를 정한 뒤 서블릿 컨텍스트에 Spring 디스패처를 등록하고 루트 컨텍스트 생명주기를 묶어야 합니다. 라이브러리 버전이 어긋나면 컴파일은 되지만 시작에 NoSuchMethodError가 날 수 있습니다. 운영 환경마다 구성 파일과 로그, 단계적 종료도 필요합니다.

package board.boot;

import java.util.List;

public final class AssemblyInventory {
    record Step(String owner, String failureSignal) { }

    public static void main(String[] args) {
        var steps = List.of(
                new Step("web server", "port bind failure"),
                new Step("servlet container", "mapping missing"),
                new Step("Spring context", "bean creation failure"),
                new Step("dependency graph", "linkage error"),
                new Step("operations", "health unknown"));
        System.out.printf("assemblySteps=%d firstFailure=%s%n",
                steps.size(), steps.getFirst().failureSignal());
    }
}

assemblySteps=5 firstFailure=port bind failure

Boot는 이 단계를 없애는 것이 아니라 라이브러리가 검증한 구성으로 이동합니다. 실패가 사라지지 않고 조건 보고서와 시작 예외로 더 일찍 보입니다.

스타터·의존성 관리

스타터는 빈 JAR 하나가 기능을 구현한다기보다 관련 의존성을 한 의도로 모읍니다. Web MVC 스타터는 MVC, JSON, 검증, 로깅, 내장 서버 조합을 일관된 버전 집합에서 가져옵니다. 애플리케이션은 Boot BOM이 관리하는 의존성에 버전을 반복하지 않습니다.

관리 밖 라이브러리는 버전을 직접 선택하고 CVE·Java 호환성을 책임집니다. 전이 의존성 재정의를 추가하면 왜 Boot 관리 범위를 벗어났는지 기록하고 의존성 분석 결과와 기본 구동 검증을 남깁니다.

스타터를 모두 넣는 방식은 클래스 경로를 키우고 원치 않는 자동 구성을 활성화합니다. 실제 기능 기준으로 선택하고 사용하지 않는 데이터베이스 드라이버나 Actuator 메트릭 내보내기 구현체를 제거합니다.

조건부 자동 구성

Boot는 후보 구성 목록을 읽고 현재 환경 조건에 맞는 빈을 등록합니다. MVC 클래스가 있고 리액티브 클래스가 없는지, 사용자 빈이 이미 있는지, 속성이 켜졌는지 같은 조건이 입력입니다. 사용자 빈이 있으면 자동 구성의 기본 빈이 물러나는 규칙이 핵심 재정의 확장 지점입니다.

@SpringBootApplication은 구성, 컴포넌트 스캔, 자동 구성 활성화를 묶습니다. 메인 클래스 패키지 위치가 스캔 루트가 되므로 기본값 패키지나 너무 낮은 루트에 두면 불필요한 타입을 탐색합니다.

자동 구성을 이해할 때 빈 이름만 찾지 말고 조건 평가 보고서를 읽습니다. 긍정 일치, 부정 일치, 무조건 적용되는 클래스를 구분하면 “왜 만들어졌나”와 “왜 안 만들어졌나”를 같은 방식으로 설명할 수 있습니다.

SpringApplication 준비 과정

실행 인자, 시스템 속성, 환경 변수, 구성 데이터를 환경으로 모으고 애플리케이션 타입을 판단한 뒤 컨텍스트를 만들고 새로 고침합니다. 리스너와 초기화기, 실행기가 서로 다른 생명주기 단계에서 동작합니다.

package board.boot;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class BoardApplication {
    public static void main(String[] args) {
        SpringApplication.run(BoardApplication.class, args);
    }
}

메인은 짧지만 빌드 클래스 경로와 애플리케이션 속성이 실행 입력입니다. 테스트에서 다른 메인 소스를 쓰면 스캔과 자동 구성 범위가 달라질 수 있으므로 실제 애플리케이션 클래스로 최소 구성 컨텍스트를 시작해 검증합니다.

재정의 가능한 기본값

포트, JSON 동작, 오류 노출, 연결 풀 크기를 기본값 그대로 쓸 수 있지만 운영 환경 요구에 맞는지 확인합니다. 재정의는 사용자 빈, 속성, 커스터마이저, 제외 중 가장 작은 확장 지점을 사용합니다. 자동 구성 클래스 전체를 복사하면 업그레이드 이점을 잃습니다.

제외는 특정 기본값이 애플리케이션 아키텍처와 맞지 않을 때 사용하고 이유와 대체 빈을 남깁니다. 시작만 통과하려고 제외를 늘리면 필수 기능이 빠질 수 있습니다.

Boot 버전 업그레이드에서는 릴리스 마이그레이션 안내서, 의존성 차이, 조건 보고서 차이, 통합 테스트를 확인합니다. 컴파일 성공만으로 생성된 구성 의미가 같다고 보지 않습니다.

시작·실행 진단 분리

빈 정의 충돌, 누락 클래스, 유효하지 않은 구성 속성은 시작에 실패시키는 것이 안전합니다. DB 일시 장애처럼 실행 중 변할 상태는 상태와 재시도로 표현할 수 있습니다. 필수 스키마가 없는데 준비로 표시하지 않습니다.

시작 시간, 빈 개수, 조건 결과, 웹 서버 포트를 기준선으로 두면 스타터 추가가 애플리케이션에 미친 영향을 찾기 쉽습니다. 디버그 보고서를 운영 환경의 모든 부팅에 무제한 출력하지 않고 문제 재현 환경에서 활성화합니다.

수동 조립과 Boot 기본값을 비교할 때 “설정 파일 수”만 세지 않습니다. 첫 HTTP 응답까지 걸린 시간, 잘못된 속성이 시작 단계에서 차단되는지, 단계적 종료 중 유실된 요청, 의존성 업그레이드 후 조건 변화까지 같은 인수 시나리오로 측정합니다. 관례가 이 증거를 안정적으로 제공할 때만 유지하고, 요구가 달라지면 가장 작은 사용자 정의 확장 지점으로 수정합니다.

연습 문제

Boot 없이 MVC 서버를 조립할 때 필요한 단계와 Boot가 제공하는 대응 추상화를 표로 만드세요. 각 기본값을 그대로 쓸 조건, 사용자 빈으로 재정의할 조건, 완전히 제외할 조건을 회원 게시판 요구에 맞게 정하세요.

package board.boot;

public record BootDecision(
        String capability,
        Choice choice,
        String evidence
) {
    public enum Choice { DEFAULT, OVERRIDE, EXCLUDE }

    public BootDecision {
        if (capability.isBlank() || evidence.isBlank()) {
            throw new IllegalArgumentException("decision evidence required");
        }
    }
}