자동 구성 (Auto Configuration)

🔍 개요

• Spring Boot는 클래스패스 + 환경설정을 검사해, 필요 Bean을 자동 등록한다.
• 사용자가 직접 Bean을 정의하면 자동 구성은 물러난다(back off)
• 비활성화/제외, 속성 튜닝, 사용자 Bean 정의로 쉽게 커스터마이징할 수 있다.

---

☝🏻 한줄 요약

자동 구성은 @SpringBootApplication(내부에 @EnableAutoConfiguration)을 통해, 라이브러리 존재/속성/환경 조건을 만족할 때 자동으로 Bean을 만드는 기능이다.

---

🤔 어떻게 동작?

• 엔트리 포인트: @SpringBootApplication → @EnableAutoConfiguration
• 자동 설정 소스: spring-boot-autoconfigure 모듈의 각 @AutoConfiguration 클래스
  • Spring Boot 3.x: META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports를 통해 등록
• 평가 로직: @ConditionalOnClass, @ConditionalOnMissingBean, @ConditionalOnProperty 등 조건이 만족되면 Bean 등록
• Back-off 규칙: 동일 타입 Bean을 사용자가 정의하면 @ConditionalOnMissingBean 조건이 깨져 자동 구성은 비활성

---

🧩 자주 쓰이는 조건들

• @ConditionalOnClass: 특정 클래스가 classpath에 있을 때만
• @ConditionalOnMissingBean: 동일 타입 Bean이 없을 때만
• @ConditionalOnProperty: 속성(foo.enabled=true)이 켜졌을 때만
• @ConditionalOnWebApplication / @ConditionalOnNotWebApplication
• @ConditionalOnBean / @ConditionalOnMissingClass

---

🔧 예시

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

# application.yml - 속성으로 자동 구성 튜닝
server:
  port: 8081
spring:
  datasource:
    url: jdbc:postgresql://...
    username: app
    password: secret

---

⚠️ 주의할 점

• 클래스패스 의존: 스타터가 끼면 의도치 않게 자동 구성이 켜질 수 있음(조건 로그로 확인)
• 중복 Bean 경합: 동일 타입 다수 등록 시 우선순위/Primary 확인
• 테스트 컨텍스트: @SpringBootTest는 광범위 → 슬라이스 테스트(@WebMvcTest, @DataJpaTest)로 범위 축소 권장

---

🔗 관련

• IoC - 컨테이너가 생성·주입·생명주기를 관리하는 기반 원리
• DI - 자동 등록된 Bean의 의존성 주입
• external-configuration - 환경/프로필 기반 설정 분리