@Lazy(false)

@Lazy(false)는 해당 Bean을 애플리케이션 시작 시점에 미리 초기화하라는 뜻입니다.

@Bean
@Lazy(false)
public List<GroupedOpenApi> apis(SwaggerUiConfigParameters swaggerUiConfigParameters, RouteDefinitionLocator locator) {
    List<GroupedOpenApi> groups = new ArrayList<>();

    List<RouteDefinition> definitions = locator.getRouteDefinitions().log("OpenApiDocConfig").collectList().block();

    Optional.ofNullable(definitions)
        .map(Collection::stream)
        .orElseGet(Stream::empty)
        .filter(routeDefinition -> routeDefinition.getId().matches(".*-service"))
        .forEach(routeDefinition -> {
            String name = routeDefinition.getId();
            swaggerUiConfigParameters.addGroup(name);
            GroupedOpenApi.builder().pathsToMatch("/" + name + "/**").group(name).build();
        });
    return groups;
}

🔍 구체적으로 설명

기본적으로 Spring Bean은 2가지 방식으로 초기화됩니다:

1. Eager Initialization (기본) – 애플리케이션 시작 시점에 Bean을 생성
2. Lazy Initialization – 실제로 해당 Bean이 필요할 때 (즉, 누군가가 참조할 때) 생성

@Lazy(false)는 이 Bean이 지연 초기화되지 않고, 즉시 초기화되도록 강제합니다.
즉, Spring이 시작될 때 이 apis(...) 메서드를 호출해서 반환된 List<GroupedOpenApi> Bean을 미리 만들어 놓습니다.

---

🤔 왜 @Lazy(false)를 붙였을까?

이 코드에서 중요한 부분은:

List<RouteDefinition> definitions = locator.getRouteDefinitions().log("OpenApiDocConfig").collectList().block();

이 라인입니다.

• RouteDefinitionLocator를 통해 게이트웨이 라우팅 정보를 가져와서,
• 각 서비스별로 Swagger 문서를 자동 그룹화합니다.

문제는:

• RouteDefinitionLocator.getRouteDefinitions()는 비동기 Flux 스트림입니다.
• 이걸 block()으로 동기적으로 호출하고 있는데,
• Lazy 초기화일 경우, 이 로직이 실행되지 않아 Swagger 문서가 UI에 나타나지 않게 될 수 있습니다.

그래서 개발자는 명시적으로 @Lazy(false)를 붙여, 애플리케이션 부팅 시 Swagger 문서가 정확히 설정되도록 보장하고자 한 것입니다.

---

정리

항목설명

@Lazy(false) 의미	해당 Bean을 앱 시작 시점에 즉시 초기화
사용 이유	비동기 RouteDefinition을 block하여 Swagger 설정을 정확히 반영하기 위함
대안	Spring 설정 전체를 lazy-init으로 두는 대신 특정 Bean만 eager로 지정할 때 유용