SPRING BOOT SERIES - LẮP RÁP

Circular Dependency: Spring Cho Mượn Bean Chưa Lắp Xong Thế Nào?

BEAN LIFECYCLE - XANH = TẦNG PHÓNG TOEarly singleton exposure chỉ có thể nối một số vòng setter/field. Constructor cycle không có instance để cho mượn.

Constructor A -> B -> A

A chưa instantiate xong khi B đòi A; không có object reference nào để expose sớm.

Cùng một vòng thiết kếBa cache chỉ là cơ chế hoàn tất một số graph. Boot khóa circular references mặc định để vòng lộ ra lúc startup.

Setter/field A -> B -> A

Nếu cho phép circular reference, A có thể instantiate trước rồi được expose qua factory cho B.

Mức 1 - tạo singleton

AbstractAutowireCapableBeanFactory.doCreateBean()

Instantiate trước, populate và initialize sau

  1. createBeanInstance()Constructor/factory method tạo raw instance.
  2. earlySingletonExposureChỉ true cho singleton đang creation và allowCircularReferences.
  3. addSingletonFactory(...)Đặt factory có thể gọi getEarlyBeanReference().
  4. populateBean()Dependency injection diễn ra sau khi raw instance đã tồn tại.
  5. initializeBean()Aware callbacks, init methods và post-processors có thể tạo proxy.
  6. Reconcile early referenceSpring kiểm tra object cho mượn có khớp exposed object cuối cùng hay không.
Mức 2 - ba tầng singleton cache

DefaultSingletonBeanRegistry.getSingleton()

Chỉ tra early reference khi bean đang creation

  1. singletonObjectsTầng 1: singleton hoàn tất, lookup thông thường trả từ đây.
  2. earlySingletonObjectsTầng 2: early reference đã materialize và được cache.
  3. singletonFactoriesTầng 3: factory tạo early reference, có cơ hội trả proxy sớm.
  4. singletonFactory.getObject()Promotion factory -> early object xảy ra khi dependency thật sự đòi bean.
  5. addSingleton()Khi bean hoàn tất, đặt vào tầng 1 và xóa hai entry tạm.
Mức 3 - guardrail và lối ra

allowCircularReferences

Chạy được không đồng nghĩa graph đã an toàn

  1. Boot mặc định falseTừ Boot 2.6, vòng bị từ chối trừ khi mở cờ rõ ràng.
  2. Constructor cycle vẫn thất bạiChưa có raw instance để đặt factory trước khi resolve constructor argument.
  3. @Lazy ở injection pointInject một proxy trì hoãn lookup, không xóa dependency cycle trong thiết kế.
  4. Raw/proxy mismatch có thể bị từ chốiBeanPostProcessor tạo wrapper muộn có thể làm dependent bean giữ raw object sai.
  5. Tách trách nhiệm CCho A và B cùng phụ thuộc abstraction/thành phần thứ ba, biến vòng thành graph có hướng rõ.

Phép kiểm: tạo riêng một vòng constructor và một vòng setter, breakpoint tại doCreateBean(), addSingletonFactory() và getSingleton(beanName, true). Quan sát bean name đi qua ba map và runtime class của early/final reference.

Gỡ vòng ở thiết kế

  • Vẽ graph dependency có hướngTìm trách nhiệm hoặc port chung đang bị kẹp giữa A và B.
  • Tách orchestration thành bean thứ baGiữ service lõi một chiều và test độc lập.
  • Dùng event/callback khi thật sự bất đồng bộKhông đổi một lời gọi trực tiếp thành event chỉ để che vòng.

Khi KHÔNG được kết luận

  • Field injection chữa circular dependencyNó chỉ cho cơ chế early exposure cơ hội nối vòng.
  • Bật cờ nghĩa là Spring bảo đảm proxy đúngRaw injection và wrapping muộn vẫn có guardrail riêng.
  • @Lazy luôn là fix thiết kếNó trì hoãn lookup; coupling hai chiều vẫn tồn tại.