@ComponentScan — 스프링은 빈을 어떻게 자동으로 찾아낼까

@Configuration
public class AppConfig {
    @Bean public UserService userService() { return new UserService(userRepository()); }
    @Bean public UserRepository userRepository() { return new UserRepository(); }
    @Bean public OrderService orderService() { return new OrderService(orderRepository()); }
    @Bean public OrderRepository orderRepository() { return new OrderRepository(); }
    // ... 수십~수백 개의 빈을 수동으로 등록
}

1. @ComponentScan의 basePackages 확인
   (미지정 시 → 현재 클래스의 패키지)
2. 해당 패키지와 하위 패키지의 모든 .class 파일 탐색
3. 각 클래스의 어노테이션 검사
   (@Component, @Service, @Repository, @Controller 등)
4. 필터 조건 확인 (include/exclude)
5. 통과한 클래스를 BeanDefinition으로 등록
6. 빈 이름 결정 (클래스명의 camelCase)

@Component                  // 범용 컴포넌트
├── @Service                // 비즈니스 로직 계층
├── @Repository             // 데이터 접근 계층 (+ 예외 변환)
├── @Controller             // 웹 MVC 컨트롤러
│   └── @RestController     // @Controller + @ResponseBody
└── @Configuration          // 설정 클래스 (+ CGLIB 프록시)

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Component  // ← @Service 안에 @Component가 있음
public @interface Service {
    String value() default "";
}

@Repository
public class UserRepository {
    public User findById(Long id) {
        // JDBC에서 SQLException이 발생하면
        // → 스프링의 DataAccessException으로 자동 변환
    }
}

// 문자열로 패키지 지정 (오타 위험)
@ComponentScan(basePackages = "com.example.app")

// 클래스 기반으로 패키지 지정 (타입 안전)
@ComponentScan(basePackageClasses = AppConfig.class)

// 여러 패키지 지정
@ComponentScan(basePackages = {"com.example.service", "com.example.repository"})

@Configuration
@ComponentScan("com.example.app")
public class AppConfig {
    // @Bean 메서드 없이도 com.example.app 하위의 모든 컴포넌트가 빈으로 등록됨
}

@SpringBootApplication // 내부에 @ComponentScan 포함
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

com.example.app
├── MyApplication.java       ← 여기에 @SpringBootApplication
├── controller/
│   └── UserController.java  ← 스캔됨
├── service/
│   └── UserService.java     ← 스캔됨
└── repository/
    └── UserRepository.java  ← 스캔됨

@Configuration
@ComponentScan(
    basePackages = "com.example",
    // 특정 어노테이션이 붙은 클래스만 포함
    includeFilters = @ComponentScan.Filter(
        type = FilterType.ANNOTATION,
        classes = MyCustomAnnotation.class
    ),
    // 특정 패턴의 클래스를 제외
    excludeFilters = @ComponentScan.Filter(
        type = FilterType.REGEX,
        pattern = "com\\.example\\.legacy\\..*"
    )
)
public class AppConfig {}

// 어노테이션 기반
@ComponentScan.Filter(type = FilterType.ANNOTATION, classes = Deprecated.class)

// 타입(클래스) 기반
@ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, classes = LegacyService.class)

// 정규식 기반
@ComponentScan.Filter(type = FilterType.REGEX, pattern = ".*Stub.*")

// AspectJ 패턴
@ComponentScan.Filter(type = FilterType.ASPECTJ, pattern = "com.example..*Service+")

// 커스텀 필터
@ComponentScan.Filter(type = FilterType.CUSTOM, classes = MyTypeFilter.class)

public class MyTypeFilter implements TypeFilter {
    @Override
    public boolean match(MetadataReader metadataReader,
                         MetadataReaderFactory metadataReaderFactory) {
        // 클래스 메타데이터를 기반으로 포함 여부 결정
        String className = metadataReader.getClassMetadata().getClassName();
        return className.contains("Special");
    }
}

// com.example.service 패키지
@Service
public class UserService { }

// com.example.admin 패키지 (다른 패키지에 같은 이름)
@Service
public class UserService { }

// 방법 1: 빈 이름 명시
@Service("adminUserService")
public class UserService { }

// 방법 2: 하나를 @Primary로 지정
@Primary
@Service
public class UserService { }

# application.yml
logging:
  level:
    org.springframework.context.annotation: DEBUG

@Component
public class MyService {
    // 자동 등록
}

@Configuration
public class AppConfig {
    @Bean
    public MyService myService() {
        return new CustomMyService(); // 수동 등록
    }
}