[스프링 핵심 원리와 활용] 섹션6. 자동 구성 Auto Configuration

[724thomas]

1. 자동 구성이란?

1-1. 개념

• 스프링 부트는 개발자가 별도로 설정하지 않아도, 자동으로 적절한 설정을 적용해주는 기능을 제공함
• 스프링 부트의 핵심 기능 중 하나로, @EnableAutoConfiguration 또는 @SpringBootApplication에 포함되어 있음

1-2. 왜 필요한가?

• 초기 설정을 간소화하여 빠른 개발 가능
• 일반적으로 사용하는 설정들을 자동으로 적용

---

2. 자동 구성의 동작 방식

2-1. @SpringBootApplication의 구성

@SpringBootApplication
==> @Configuration
    + @EnableAutoConfiguration
    + @ComponentScan

• @EnableAutoConfiguration 덕분에 다양한 설정이 자동으로 적용됨

2-2. 자동 구성이 동작하는 방식

• spring-boot-autoconfigure 모듈 내부의 META-INF/spring.factories 또는 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 파일에서 자동 구성 클래스 목록을 정의함
• 클래스패스에 존재하는 조건에 따라 자동 구성 클래스를 적용할지 여부를 판단함

---

3. 조건부 자동 설정

3-1. 대표적인 조건 어노테이션

어노테이션	설명
@ConditionalOnClass	특정 클래스가 클래스패스에 존재할 때만 설정 적용
@ConditionalOnMissingBean	해당 타입의 Bean이 없을 경우에만 설정 적용
@ConditionalOnProperty	특정 속성의 값이 지정되어 있을 경우에만 설정 적용
@ConditionalOnBean	지정한 Bean이 존재할 경우에만 설정 적용

3-2. 예시 코드

@Bean
@ConditionalOnMissingBean
public DefaultEventPublisher publisher(ApplicationEventPublisher publisher) {
    return new DefaultEventPublisher(publisher);
}

---

4. 자동 구성 클래스 예시: SecurityAutoConfiguration

4-1. spring-boot-autoconfigure 내부 구성 예시

@AutoConfiguration(before = UserDetailsServiceAutoConfiguration.class)
@ConditionalOnClass(DefaultAuthenticationEventPublisher.class)
@EnableConfigurationProperties(SecurityProperties.class)
@Import({ SpringBootWebSecurityConfiguration.class, SecurityDataConfiguration.class })
public class SecurityAutoConfiguration {
    @Bean
    @ConditionalOnMissingBean(AuthenticationEventPublisher.class)
    public DefaultAuthenticationEventPublisher authenticationEventPublisher(ApplicationEventPublisher publisher) {
        return new DefaultAuthenticationEventPublisher(publisher);
    }
}

4-2. 해석

• @AutoConfiguration: 자동 구성 클래스임을 명시
• @ConditionalOnClass: 특정 클래스가 있을 경우에만 활성화
• @Import: 실질적인 설정 클래스 로드

---

5. 사용자 정의 자동 구성

5-1. 직접 자동 구성 만들기

1. 새로운 구성 클래스를 생성
2. @Configuration 또는 @AutoConfiguration 사용
3. spring.factories 또는 AutoConfiguration.imports에 클래스 등록

5-2. 실습 예시

@Configuration
public class MyAutoConfiguration {
    @Bean
    public HelloService helloService() {
        return new HelloService();
    }
}

---

6. 자동 구성 비활성화

6-1. 특정 자동 구성 제외

@SpringBootApplication(exclude = { SecurityAutoConfiguration.class })

6-2. application.yml에서 설정 비활성화

spring:
  autoconfigure:
    exclude:
      - org.springframework.boot.autoconfigure.security.servlet.SecurityAutoConfiguration

---

7. 정리

항목	설명
자동 구성	스프링 부트가 클래스패스, 빈 등록 유무, 프로퍼티 유무 등을 기준으로 설정 자동화
조건부 어노테이션	특정 조건이 만족될 때만 빈을 등록
커스텀 자동 구성	직접 정의한 설정도 자동 구성이 가능
제외 방법	어노테이션 또는 YML로 설정 비활성화 가능

• 자동 구성은 스프링 부트의 핵심 기능 중 하나로, 설정을 간소화하고 빠른 개발을 지원함
• 조건부 로딩을 통해 유연한 구성 가능
• 필요시 자동 구성 비활성화도 가능

---