Spring Boot

작성자

익명

작성일

2026.07.26

조회수

버전

일반 문서

📋 문서 버전

이 문서는 3개의 버전이 있습니다. 현재 최신 버전을 보고 있습니다.

Spring Boot

요

Spring Boot는 자 기반의 오픈소스 프레임워크로, 스프링 프임워크 기의 애플리케이을 보다 빠르고 쉽게 개발할 수 있도록 설계된 도구입니다. 스프링 프레워크의 복한 설정과 구성의 번거로움을 줄이고, "기본값으로 시작하고 필요한 경우만 오버라이드"하는 원칙을 따르며, 개발자가 빠르게 프로토타입을 구축하고 서비스를 배포할 수 있도록 돕습니다.

Spring Boot는 마이크로서비스 아키텍처, RESTful API, 웹 애플리케이션, 배치 처리 시스템 등 다양한 유형의 애플리케이션 개발에 널리 사용되며, 특히 클라우드 네이티브 애플리케이션 개발에 최적화되어 있습니다.

주요 특징

1. 자동 구성 (Auto-configuration)

Spring Boot는 애플리케이션의 클래스패스와 설정에 따라 필요한 빈(Bean)과 구성 요소를 자동으로 설정합니다. 예를 들어, spring-boot-starter-web을 포함하면 내장된 톰캣 서버와 스프링 MVC가 자동으로 설정되어 웹 애플리케이션을 즉시 실행할 수 있습니다.

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

위 코드 한 줄로 웹 서버가 실행되며, 별도의 XML 설정이나 복잡한 초기화 과정이 필요하지 않습니다.

2. 독립형 실행 가능 (Standalone Application)

Spring Boot 애플리케이션은 내장 서버(예: Tomcat, Jetty, Undertow)를 포함하므로 별도의 외부 애플리케이션 서버 없이 JAR 파일로 직접 실행할 수 있습니다. 이는 배포와 운영을 간소화합니다.

java -jar myapp.jar

3. 스타터 의존성 (Starter Dependencies)

Spring Boot는 다양한 기능을 쉽게 추가할 수 있도록 미리 정의된 "스타터(starter)" 의존성을 제공합니다. 예를 들어:

spring-boot-starter-web: 웹 애플리케이션 개발
spring-boot-starter-data-jpa: 데이터베이스 접근 (JPA)
spring-boot-starter-security: 보안 기능
spring-boot-starter-test: 테스트 지원

이러한 스타터들은 관련 라이브러리들을 묶어주며, 버전 충돌을 최소화합니다.

4. 액추에이터 (Actuator)

Spring Boot Actuator는 애플리케이션의 운영 정보(헬스 체크, 메트릭스, 로그 레벨 조정 등)를 모니터링하고 관리할 수 있는 엔드포인트를 제공합니다. 운영 환경에서 시스템 상태를 실시간으로 확인하는 데 유용합니다.

예: /actuator/health, /actuator/metrics

5. 외부화된 구성 (Externalized Configuration)

환경별 설정을 application.properties 또는 <a href="/doc/%EA%B8%B0%EC%88%A0/%EC%86%8C%ED%94%84%ED%8A%B8%EC%9B%A8%EC%96%B4%20%EA%B0%9C%EB%B0%9C/%EC%99%B8%EB%B6%80%ED%99%94%EB%90%9C%20%EA%B5%AC%EC%84%B1/application.yml" class="wiki-link wiki-link-missing">application.yml</a> 파일을 통해 관리할 수 있으며, 프로파일을 사용해 개발, 테스트, 운영 환경을 분리할 수 있습니다.

# application.yml
spring:
  profiles:
    active: dev

---
spring:
  profiles: dev
server:
  port: 8080

---
spring:
  profiles: prod
server:
  port: 80

주요 구성 요소

@SpringBootApplication 애노테이션

이 애노테이션은 다음 세 가지를 결합한 별칭입니다:

@SpringBootConfiguration: 스프링 구성 클래스임을 나타냄
@EnableAutoConfiguration: 자동 구성 활성화
@ComponentScan: 컴포넌트 스캔 활성화

내장 서버

기본적으로 Tomcat이 내장되어 있지만, 필요에 따라 Jetty 또는 Undertow로 교체 가능합니다.

<!-- pom.xml에서 Tomcat 제외하고 Jetty 사용 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jetty</artifactId>
</dependency>

개발 및 배포

프로젝트 생성

Spring Initializr를 사용하면 웹 기반으로 프로젝트를 쉽게 생성할 수 있습니다. 원하는 의존성을 선택하고 ZIP 파일로 다운로드받아 즉시 개발을 시작할 수 있습니다.

빌드 도구 지원

Maven: pom.xml 기반
Gradle: build.gradle 기반

컨테이너 배포

Spring Boot 애플리케이션은 Docker와 잘 통합되며, 다음과 같이 컨테이너화할 수 있습니다:

FROM openjdk:17-jre-slim
COPY target/myapp.jar app.jar
ENTRYPOINT ["java", "-jar", "/app.jar"]

생태계 및 확장성

Spring Boot는 Spring Cloud, Spring Data, Spring Security, Spring Batch 등 다양한 스프링 프로젝트와 긴밀하게 연동되어 마이크로서비스, 데이터 처리, 보안 등 복잡한 아키텍처를 쉽게 구현할 수 있습니다.

또한, 커뮤니티 기반의 많은 서드파티 스타터와 플러그인들이 존재하여, AWS, Kafka, Redis, MongoDB 등 다양한 기술과의 통합이 용이합니다.

참고 자료 및 관련 문서

Spring Boot는 현대 자바 개발의 표준으로 자리 잡았으며, 개발 생산성과 운영 편의성을 동시에 제공하는 강력한 오픈소스 프레임워크입니다. 기업급 애플리케이션에서부터 스타트업의 빠른 프로토타이핑까지 폭넓게 활용되고 있습니다.

프레임워크 정체성 및 관계

Spring Boot는 Java 기반의 Spring Framework를 더 쉽고 빠르게 사용할 수 있도록 돕는 'Opinionated(주관적인)' 도구입니다. Spring Framework가 제공하는 방대한 기능과 유연함은 반대로 복잡한 설정(XML 또는 Java Config)이라는 진입장벽을 만들었습니다. Spring Boot는 "대부분의 개발자가 공통적으로 사용하는 설정"을 미리 정의하여 제공함으로써, 개발자가 인프라 설정보다는 비즈니스 로직 구현에 집중할 수 있게 하는 상위 계층의 프레임워크 역할을 수행합니다.

Spring Boot의 동작 원리

Spring Boot의 핵심은 @EnableAutoConfiguration을 통한 자동 구성 메커니즘에 있습니다.

자동 구성 프로세스

설정 로드: 애플리케이션 실행 시 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports (최신 버전) 또는 spring.factories 파일에 정의된 자동 구성 클래스 목록을 읽어옵니다.
조건부 빈 등록: 읽어온 클래스들을 무조건 등록하는 것이 아니라, @Conditional 어노테이션을 통해 특정 조건이 충족될 때만 빈(Bean)으로 등록합니다.

@Conditional 종류 및 예시

조건부 어노테이션을 통해 클래스패스나 설정 값에 따라 유연하게 빈을 생성합니다.

어노테이션	설명	예시
`@ConditionalOnClass`	특정 클래스가 클래스패스에 존재할 때만 활성화	`DataSource.class`가 있으면 DB 관련 설정 활성화
`@ConditionalOnMissingBean`	특정 빈이 등록되어 있지 않을 때만 활성화	사용자가 직접 정의한 빈이 없으면 기본 빈 등록
`@ConditionalOnProperty`	특정 설정 프로퍼티가 지정된 값일 때 활성화	`spring.jpa.hibernate.ddl-auto=update`일 때만 동작
`@ConditionalOnWebApplication`	웹 애플리케이션 환경일 때만 활성화	내장 톰캣 서버 설정 활성화

설정 우선순위 및 외부화

Spring Boot는 동일한 설정 키에 대해 여러 소스에서 값이 제공될 경우, 정해진 우선순위에 따라 값을 덮어씁니다. 이를 통해 동일한 빌드 결과물을 환경(Dev, Stage, Prod)에 따라 다르게 설정할 수 있습니다.

설정 우선순위 비교 표

(위에서 아래로 갈수록 우선순위가 높으며, 아래 항목이 위의 설정을 덮어씁니다.)

우선순위	설정 소스	예시
1	기본 설정 파일	`application.properties` / `application.yml`
2	프로파일별 설정 파일	`application-dev.yml` / `application-prod.yml`
3	OS 환경 변수	`export SERVER_PORT=9000`
4	자바 시스템 프로퍼티	`-Dserver.port=9000`
5	커맨드 라인 인자	`--server.port=9000`

Cloud Native Buildpacks 활용

최신 Spring Boot는 Dockerfile을 직접 작성하지 않고도 OCI 준수 컨테이너 이미지를 생성할 수 있는 Cloud Native Buildpacks를 지원합니다.

단계별 이미지 생성 명령어

빌드 도구(Maven/Gradle)에 내장된 플러그인을 사용하여 이미지를 생성하고 로컬 Docker 데몬이나 원격 레지스트리에 푸시할 수 있습니다.

1. Gradle 사용 시

# 로컬 Docker 이미지로 생성
./gradlew bootBuildImage

# 특정 이미지 이름 지정 및 푸시
./gradlew bootBuildImage --imageName=my-repo/my-app:v1

2. Maven 사용 시

# 로컬 Docker 이미지로 생성
./mvnw spring-boot:build-image

# 특정 이미지 이름 지정 및 푸시
./mvnw spring-boot:build-image -Dspring-boot.build-image.imageName=my-repo/my-app:v1

최신 트렌드 및 발전 방향: GraalVM Native Image

최근 Spring Boot는 Spring Native 프로젝트를 통해 GraalVM 기반의 네이티브 이미지 생성을 지원하고 있습니다.

동작 방식: 기존의 JVM 방식(JIT 컴파일)과 달리, 빌드 타임에 정적 분석을 통해 실행에 필요한 코드만 추출하여 기계어로 미리 컴파일(AOT - Ahead-of-Time)합니다.
주요 이점:
- 기동 속도(Startup Time) 획기적 개선: JVM 가동 및 클래스 로딩 시간이 사라져 밀리초(ms) 단위로 애플리케이션이 실행됩니다.
- 메모리 사용량 최적화: 런타임에 필요한 JVM 오버헤드가 제거되어 메모리 점유율이 크게 낮아집니다.
활용 사례: 서버리스(AWS Lambda, Google Cloud Functions) 환경이나 리소스 제한이 엄격한 쿠버네티스(K8s) 환경의 마이크로서비스에 최적입니다.

📝 마크다운 원본

이 문서의 마크다운 원본 내용입니다.

Spring Boot

##요

**Spring Boot**는 자 기반의 오픈소스 프레임워크로, 스프링 프임워크 기의 애플리케이을 보다 빠르고 쉽게 개발할 수 있도록 설계된 도구입니다. 스프링 프레워크의 복한 설정과 구성의 번거로움을 줄이고, "기본값으로 시작하고 필요한 경우만 오버라이드"하는 원칙을 따르며, 개발자가 빠르게 프로토타입을 구축하고 서비스를 배포할 수 있도록 돕습니다.

Spring Boot는 마이크로서비스 아키텍처, RESTful API, 웹 애플리케이션, 배치 처리 시스템 등 다양한 유형의 애플리케이션 개발에 널리 사용되며, 특히 클라우드 네이티브 애플리케이션 개발에 최적화되어 있습니다.

---

## 주요 특징

### 1. 자동 구성 (Auto-configuration)
Spring Boot는 애플리케이션의 클래스패스와 설정에 따라 필요한 빈(Bean)과 구성 요소를 자동으로 설정합니다. 예를 들어, `spring-boot-starter-web`을 포함하면 내장된 톰캣 서버와 스프링 MVC가 자동으로 설정되어 웹 애플리케이션을 즉시 실행할 수 있습니다.

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

위 코드 한 줄로 웹 서버가 실행되며, 별도의 XML 설정이나 복잡한 초기화 과정이 필요하지 않습니다.

### 2. 독립형 실행 가능 (Standalone Application)
Spring Boot 애플리케이션은 내장 서버(예: Tomcat, Jetty, Undertow)를 포함하므로 별도의 외부 애플리케이션 서버 없이 JAR 파일로 직접 실행할 수 있습니다. 이는 배포와 운영을 간소화합니다.

```bash
java -jar myapp.jar
```

### 3. 스타터 의존성 (Starter Dependencies)
Spring Boot는 다양한 기능을 쉽게 추가할 수 있도록 미리 정의된 "스타터(starter)" 의존성을 제공합니다. 예를 들어:

- `spring-boot-starter-web`: 웹 애플리케이션 개발
- `spring-boot-starter-data-jpa`: 데이터베이스 접근 (JPA)
- `spring-boot-starter-security`: 보안 기능
- `spring-boot-starter-test`: 테스트 지원

이러한 스타터들은 관련 라이브러리들을 묶어주며, 버전 충돌을 최소화합니다.

### 4. 액추에이터 (Actuator)
Spring Boot Actuator는 애플리케이션의 운영 정보(헬스 체크, 메트릭스, 로그 레벨 조정 등)를 모니터링하고 관리할 수 있는 엔드포인트를 제공합니다. 운영 환경에서 시스템 상태를 실시간으로 확인하는 데 유용합니다.

예: `/actuator/health`, `/actuator/metrics`

### 5. 외부화된 구성 (Externalized Configuration)
환경별 설정을 `application.properties` 또는 `application.yml` 파일을 통해 관리할 수 있으며, 프로파일을 사용해 개발, 테스트, 운영 환경을 분리할 수 있습니다.

```yaml
# application.yml
spring:
  profiles:
    active: dev

---
spring:
  profiles: dev
server:
  port: 8080

---
spring:
  profiles: prod
server:
  port: 80
```

---

## 주요 구성 요소

### @SpringBootApplication 애노테이션
이 애노테이션은 다음 세 가지를 결합한 별칭입니다:

- `@SpringBootConfiguration`: 스프링 구성 클래스임을 나타냄
- `@EnableAutoConfiguration`: 자동 구성 활성화
- `@ComponentScan`: 컴포넌트 스캔 활성화

### 내장 서버
기본적으로 Tomcat이 내장되어 있지만, 필요에 따라 Jetty 또는 Undertow로 교체 가능합니다.

```xml
<!-- pom.xml에서 Tomcat 제외하고 Jetty 사용 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jetty</artifactId>
</dependency>
```

---

## 개발 및 배포

### 프로젝트 생성
[Spring Initializr](https://start.spring.io)를 사용하면 웹 기반으로 프로젝트를 쉽게 생성할 수 있습니다. 원하는 의존성을 선택하고 ZIP 파일로 다운로드받아 즉시 개발을 시작할 수 있습니다.

### 빌드 도구 지원
- **Maven**: `pom.xml` 기반
- **Gradle**: `build.gradle` 기반

### 컨테이너 배포
Spring Boot 애플리케이션은 Docker와 잘 통합되며, 다음과 같이 컨테이너화할 수 있습니다:

```Dockerfile
FROM openjdk:17-jre-slim
COPY target/myapp.jar app.jar
ENTRYPOINT ["java", "-jar", "/app.jar"]
```

---

## 생태계 및 확장성

Spring Boot는 **Spring Cloud**, **Spring Data**, **Spring Security**, **Spring Batch** 등 다양한 스프링 프로젝트와 긴밀하게 연동되어 마이크로서비스, 데이터 처리, 보안 등 복잡한 아키텍처를 쉽게 구현할 수 있습니다.

또한, 커뮤니티 기반의 많은 서드파티 스타터와 플러그인들이 존재하여, AWS, Kafka, Redis, MongoDB 등 다양한 기술과의 통합이 용이합니다.

---

## 참고 자료 및 관련 문서

- [공식 문서](https://spring.io/projects/spring-boot)
- [Spring Initializr](https://start.spring.io)
- [GitHub 저장소](https://github.com/spring-projects/spring-boot)
- [Spring Boot Actuator 문서](https://docs.spring.io/spring-boot/docs/current/reference/html/actuator.html)

---

Spring Boot는 현대 자바 개발의 표준으로 자리 잡았으며, 개발 생산성과 운영 편의성을 동시에 제공하는 강력한 오픈소스 프레임워크입니다. 기업급 애플리케이션에서부터 스타트업의 빠른 프로토타이핑까지 폭넓게 활용되고 있습니다.

## 프레임워크 정체성 및 관계
Spring Boot는 Java 기반의 Spring Framework를 더 쉽고 빠르게 사용할 수 있도록 돕는 **'Opinionated(주관적인)'** 도구입니다. Spring Framework가 제공하는 방대한 기능과 유연함은 반대로 복잡한 설정(XML 또는 Java Config)이라는 진입장벽을 만들었습니다. Spring Boot는 "대부분의 개발자가 공통적으로 사용하는 설정"을 미리 정의하여 제공함으로써, 개발자가 인프라 설정보다는 비즈니스 로직 구현에 집중할 수 있게 하는 상위 계층의 프레임워크 역할을 수행합니다.

## Spring Boot의 동작 원리
Spring Boot의 핵심은 `@EnableAutoConfiguration`을 통한 자동 구성 메커니즘에 있습니다.

### 자동 구성 프로세스
1. **설정 로드**: 애플리케이션 실행 시 `META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports` (최신 버전) 또는 `spring.factories` 파일에 정의된 자동 구성 클래스 목록을 읽어옵니다.
2. **조건부 빈 등록**: 읽어온 클래스들을 무조건 등록하는 것이 아니라, `@Conditional` 어노테이션을 통해 특정 조건이 충족될 때만 빈(Bean)으로 등록합니다.

### @Conditional 종류 및 예시
조건부 어노테이션을 통해 클래스패스나 설정 값에 따라 유연하게 빈을 생성합니다.

| 어노테이션 | 설명 | 예시 |
| :--- | :--- | :--- |
| `@ConditionalOnClass` | 특정 클래스가 클래스패스에 존재할 때만 활성화 | `DataSource.class`가 있으면 DB 관련 설정 활성화 |
| `@ConditionalOnMissingBean` | 특정 빈이 등록되어 있지 않을 때만 활성화 | 사용자가 직접 정의한 빈이 없으면 기본 빈 등록 |
| `@ConditionalOnProperty` | 특정 설정 프로퍼티가 지정된 값일 때 활성화 | `spring.jpa.hibernate.ddl-auto=update`일 때만 동작 |
| `@ConditionalOnWebApplication` | 웹 애플리케이션 환경일 때만 활성화 | 내장 톰캣 서버 설정 활성화 |

## 설정 우선순위 및 외부화
Spring Boot는 동일한 설정 키에 대해 여러 소스에서 값이 제공될 경우, 정해진 우선순위에 따라 값을 덮어씁니다. 이를 통해 동일한 빌드 결과물을 환경(Dev, Stage, Prod)에 따라 다르게 설정할 수 있습니다.

### 설정 우선순위 비교 표
(위에서 아래로 갈수록 우선순위가 높으며, 아래 항목이 위의 설정을 덮어씁니다.)

| 우선순위 | 설정 소스 | 예시 |
| :---: | :--- | :--- |
| 1 | 기본 설정 파일 | `application.properties` / `application.yml` |
| 2 | 프로파일별 설정 파일 | `application-dev.yml` / `application-prod.yml` |
| 3 | OS 환경 변수 | `export SERVER_PORT=9000` |
| 4 | 자바 시스템 프로퍼티 | `-Dserver.port=9000` |
| 5 | 커맨드 라인 인자 | `--server.port=9000` |

## Cloud Native Buildpacks 활용
최신 Spring Boot는 `Dockerfile`을 직접 작성하지 않고도 OCI 준수 컨테이너 이미지를 생성할 수 있는 **Cloud Native Buildpacks**를 지원합니다.

### 단계별 이미지 생성 명령어
빌드 도구(Maven/Gradle)에 내장된 플러그인을 사용하여 이미지를 생성하고 로컬 Docker 데몬이나 원격 레지스트리에 푸시할 수 있습니다.

**1. Gradle 사용 시**
```bash
# 로컬 Docker 이미지로 생성
./gradlew bootBuildImage

# 특정 이미지 이름 지정 및 푸시
./gradlew bootBuildImage --imageName=my-repo/my-app:v1
```

**2. Maven 사용 시**
```bash
# 로컬 Docker 이미지로 생성
./mvnw spring-boot:build-image

# 특정 이미지 이름 지정 및 푸시
./mvnw spring-boot:build-image -Dspring-boot.build-image.imageName=my-repo/my-app:v1
```

## 최신 트렌드 및 발전 방향: GraalVM Native Image
최근 Spring Boot는 **Spring Native** 프로젝트를 통해 GraalVM 기반의 네이티브 이미지 생성을 지원하고 있습니다.

- **동작 방식**: 기존의 JVM 방식(JIT 컴파일)과 달리, 빌드 타임에 정적 분석을 통해 실행에 필요한 코드만 추출하여 기계어로 미리 컴파일(AOT - Ahead-of-Time)합니다.
- **주요 이점**:
    - **기동 속도(Startup Time) 획기적 개선**: JVM 가동 및 클래스 로딩 시간이 사라져 밀리초(ms) 단위로 애플리케이션이 실행됩니다.
    - **메모리 사용량 최적화**: 런타임에 필요한 JVM 오버헤드가 제거되어 메모리 점유율이 크게 낮아집니다.
- **활용 사례**: 서버리스(AWS Lambda, Google Cloud Functions) 환경이나 리소스 제한이 엄격한 쿠버네티스(K8s) 환경의 마이크로서비스에 최적입니다.

AI 생성 콘텐츠 안내

이 문서는 AI 모델(gemma-4-31b)에 의해 생성된 콘텐츠입니다.

주의사항: AI가 생성한 내용은 부정확하거나 편향된 정보를 포함할 수 있습니다. 중요한 결정을 내리기 전에 반드시 신뢰할 수 있는 출처를 통해 정보를 확인하시기 바랍니다.

위키너와나

Spring Boot

📋 문서 버전

요

주요 특징

1. 자동 구성 (Auto-configuration)

2. 독립형 실행 가능 (Standalone Application)

3. 스타터 의존성 (Starter Dependencies)

4. 액추에이터 (Actuator)

5. 외부화된 구성 (Externalized Configuration)

주요 구성 요소

@SpringBootApplication 애노테이션

내장 서버

개발 및 배포

프로젝트 생성

빌드 도구 지원

컨테이너 배포

생태계 및 확장성

참고 자료 및 관련 문서

프레임워크 정체성 및 관계

Spring Boot의 동작 원리

자동 구성 프로세스

@Conditional 종류 및 예시

설정 우선순위 및 외부화

설정 우선순위 비교 표

Cloud Native Buildpacks 활용

단계별 이미지 생성 명령어

최신 트렌드 및 발전 방향: GraalVM Native Image

📝 마크다운 원본

🤔 AI의 사고 과정

이 AI 생성 콘텐츠가 도움이 되었나요?