Spring Boot 핵심 개념, 트레이드오프와 실전 예제 (간결 가이드)

소개

Spring Boot는 Spring 생태계에서 빠르게 애플리케이션을 시작하고 운영하기 위해 널리 사용되는 프레임워크입니다. 핵심 아이디어는 "의존성 스타터"와 "자동설정(autoconfiguration)"을 통해 보일러플레이트를 줄이고 생산성을 높이는 것입니다. 이 글에서는 안정적인 핵심 개념을 정리하고, 실무에서 마주치는 트레이드오프를 설명한 뒤 간단한 REST 예제를 제공합니다.

핵심 개념

다음은 Spring Boot를 이해하는 데 필요한 주요 개념들입니다.

1) 스타터(Starters)
관련 라이브러리 집합을 하나의 의존성으로 묶어주는 역할입니다. 예: spring-boot-starter-web, spring-boot-starter-data-jpa.

2) 자동설정(Autoconfiguration)
클래스패스와 애플리케이션 컨텍스트 상태를 분석하여 필요한 빈을 자동으로 등록합니다. 설정을 덜어주지만, 어떤 빈이 등록되는지 명확히 이해하는 것이 중요합니다.

3) 외부설정(Externalized Configuration)
application.properties/yml, 환경 변수, 커맨드라인 인자 등을 통해 설정을 분리합니다. 프로파일을 이용해 환경별 구성을 관리할 수 있습니다.

4) 프로파일(Profiles)
dev/test/prod 같은 환경별 설정을 구분합니다. @Profile이나 spring.profiles.active로 활성화합니다.

5) 액추에이터(Actuator)
헬스체크, 메트릭, 트레이스 등 운영에 필요한 엔드포인트(예: /actuator/health, /actuator/metrics)를 제공합니다. 운영 시 필수적입니다.

6) 테스트 지원
@SpringBootTest로 통합 테스트를 간단히 작성할 수 있고, @WebMvcTest, @DataJpaTest 같은 슬라이스 테스트로 빠른 단위 검증이 가능합니다.

주요 트레이드오프 (장점과 단점)

Spring Boot는 많은 편의성을 제공하지만, 그로 인한 의사결정 상의 트레이드오프가 존재합니다.

편의성 vs 명시성
자동설정과 스타터는 빠른 개발을 돕지만 "어떤 빈이 등록되는가"를 몰라서 문제가 될 수 있습니다. 디버깅 시 의존성 트리와 자동구성 결과를 확인해야 합니다. (예: spring-boot-actuator의 /actuator/beans 또는 --debug 플래그 사용)

메모리/시작시간 vs 생산성
표준 JVM으로 실행하면 런타임 유연성과 디버깅 편의성이 높지만 메모리 소비와 시작 시간이 큽니다. 반면 네이티브 이미지(GraalVM)는 빠른 시작과 낮은 메모리를 제공하지만 빌드 복잡성, 서드파티 라이브러리의 호환성, 리플렉션 설정 부담이 있습니다.

모노리식 vs 마이크로서비스
Spring Boot는 마이크로서비스 구축에 적합하지만 서비스 수가 늘어나면 운영 복잡도가 증가합니다. 작은 서비스 여러 개로 분리하면 배포 유연성이 높아지지만 분산 트랜잭션, 네트워크 비용, 모니터링 복잡성이 증가합니다.

자동화된 설정의 의존성
자동설정에 지나치게 의존하면 특정 요구사항에서 커스터마이징이 어려워질 수 있습니다. 필요한 경우 명시적으로 빈을 정의하거나 자동설정을 비활성화해야 합니다.

실전 예제: 간단한 Todo REST API

아래 예제는 Spring Boot로 간단한 CRUD REST API를 만드는 최소 구성입니다. 영속성 대신 메모리 기반 저장소를 사용해 구조와 구성 포인트를 보여줍니다.

프로젝트 구조(간략):

src/main/java/com/example/todo/
  Application.java
  controller/TodoController.java
  service/TodoService.java
  model/Todo.java

pom.xml(핵심 의존성 스니펫):

<project xmlns="http://maven.apache.org/POM/4.0.0" ...>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example</groupId>
  <artifactId>todo-app</artifactId>
  <version>0.0.1-SNAPSHOT</version>

  <properties>
    <java.version>17</java.version>
    <spring.boot.version>3.0.0</spring.boot.version> 
  </properties>

  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-test</artifactId>
      <scope>test</scope>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>
</project>

Application.java:

package com.example.todo;

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

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

Todo 모델:

package com.example.todo.model;

public class Todo {
    private Long id;
    private String title;
    private boolean done;

    // 생성자, getter/setter 생략(또는 Lombok 사용 가능)

    public Todo() {}

    public Todo(Long id, String title, boolean done) {
        this.id = id;
        this.title = title;
        this.done = done;
    }

    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
    public String getTitle() { return title; }
    public void setTitle(String title) { this.title = title; }
    public boolean isDone() { return done; }
    public void setDone(boolean done) { this.done = done; }
}

TodoService(간단한 메모리 저장소):

package com.example.todo.service;

import com.example.todo.model.Todo;
import org.springframework.stereotype.Service;

import java.util.*;
import java.util.concurrent.atomic.AtomicLong;

@Service
public class TodoService {
    private final Map store = new HashMap<>();
    private final AtomicLong seq = new AtomicLong(1);

    public List<Todo> findAll() {
        return new ArrayList<>(store.values());
    }

    public Optional<Todo> findById(Long id) {
        return Optional.ofNullable(store.get(id));
    }

    public Todo create(Todo todo) {
        long id = seq.getAndIncrement();
        todo.setId(id);
        store.put(id, todo);
        return todo;
    }

    public Optional<Todo> update(Long id, Todo todo) {
        if (!store.containsKey(id)) return Optional.empty();
        todo.setId(id);
        store.put(id, todo);
        return Optional.of(todo);
    }

    public boolean delete(Long id) {
        return store.remove(id) != null;
    }
}

TodoController:

package com.example.todo.controller;

import com.example.todo.model.Todo;
import com.example.todo.service.TodoService;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

import java.net.URI;
import java.util.List;

@RestController
@RequestMapping("/api/todos")
public class TodoController {
    private final TodoService service;

    public TodoController(TodoService service) {
        this.service = service;
    }

    @GetMapping
    public List<Todo> list() {
        return service.findAll();
    }

    @GetMapping("/{id}")
    public ResponseEntity<Todo> get(@PathVariable Long id) {
        return service.findById(id)
                .map(ResponseEntity::ok)
                .orElse(ResponseEntity.notFound().build());
    }

    @PostMapping
    public ResponseEntity<Todo> create(@RequestBody Todo todo) {
        Todo created = service.create(todo);
        return ResponseEntity.created(URI.create("/api/todos/" + created.getId())).body(created);
    }

    @PutMapping("/{id}")
    public ResponseEntity<Todo> update(@PathVariable Long id, @RequestBody Todo todo) {
        return service.update(id, todo)
                .map(ResponseEntity::ok)
                .orElse(ResponseEntity.notFound().build());
    }

    @DeleteMapping("/{id}")
    public ResponseEntity<Void> delete(@PathVariable Long id) {
        if (service.delete(id)) return ResponseEntity.noContent().build();
        return ResponseEntity.notFound().build();
    }
}

application.properties(기본 포트 설정 예):

server.port=8080
spring.application.name=todo-app

간단한 Dockerfile (JAR를 빌드한 후 사용):

FROM eclipse-temurin:17-jdk-jammy
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
EXPOSE 8080
ENTRYPOINT ["java","-jar","/app.jar"]

실무 적용 시 팁

- 자동설정 결과가 궁금하면 애플리케이션을 --debug로 실행하거나 Actuator의 beans/conditions 엔드포인트를 확인하세요.
- 프로파일을 통해 비밀값(시크릿)은 Vault, Kubernetes Secrets 또는 클라우드 provider의 비밀관리 솔루션과 연동하세요.
- 대규모 배포를 계획한다면 메모리/시작 시간 요구사항에 따라 컨테이너 크기와 JVM 옵션을 조정하세요. 네이티브 이미지는 장단점을 고려해 선택하세요.

결론

Spring Boot는 생산성과 운영 편의성을 크게 향상시켜 주지만, 자동설정의 "마법"이 때로는 복잡도를 숨길 수 있습니다. 핵심 개념(스타터, 자동설정, 외부설정, 프로파일, 액추에이터 등)을 이해하고 트레이드오프를 고려하면 안정적이고 확장 가능한 애플리케이션을 설계할 수 있습니다. 본문 예제는 시작점입니다—실무에서는 보안, 로깅, 모니터링, 배포 전략을 추가로 설계해야 합니다.