---
category: Unified
tags: [auto-consolidated, technical-documentation]
title: [[Dependency-Injection|Dependency-Injection]] (의존성 주입)
last_updated: 2026-05-02
---

# [[Dependency-Injection|Dependency-Injection]] (의존성 주입)

## 📌 Brief Summary
> "직접 사러 가지 말고, 배달받아 써라." 객체가 필요한 의존 객체를 스스로 생성하지 않고, 외부에서 주입받음으로써 코드 간의 결합도를 낮추고 테스트 용이성을 극대화하는 디자인 패턴이다.

---

**의존성 주입(Dependency Injection, DI)**은 객체 지향 프로그래밍에서 객체 간의 결합도를 낮추기 위해 사용되는 설계 패턴입니다. 객체가 내부에서 필요한 의존 객체를 직접 생성(new)하지 않고, 인터페이스를 통해 외부(프레임워크나 컨테이너)로부터 주입받는 방식을 의미합니다. 이는 SOLID 원칙 중 하나인 **의존성 역전 원칙(DIP)**을 실현하는 핵심 메커니즘으로, 코드의 유연성, 재사용성, 그리고 테스트 용이성을 획기적으로 향상시킵니다.

---

---

> 의존성 주입(Dependency Injection, DI)은 모듈이 필요로 하는 의존성 객체를 내부에서 직접 생성하지 않고 외부로부터 제공(주입)받도록 설계하는 소프트웨어 패턴입니다 [1, 2]. 이 기법은 시스템 컴포넌트 간의 결합도를 낮추어 코드의 모듈화를 촉진하며 [2, 3], 궁극적으로 애플리케이션의 유지보수성과 테스트 용이성을 크게 향상시키는 데 목적이 있습니다 [3, 4].

---

의존성 주입(Dependency Injection, DI)은 상위 계층이 하위 계층의 인스턴스를 직접 생성하는 대신, 외부에서 의존성을 "주입"하여 구성 요소 간의 결합도를 낮추는 소프트웨어 엔지니어링 기법이다 [1]. 핵심 비즈니스 로직을 변경하지 않고도 종속성을 관리하거나 특정 구현체를 쉽게 교체할 수 있게 해준다 [2]. 의존성 역전 원칙(DIP)을 달성하기 위한 대표적인 구현 방법으로 사용되며, 애플리케이션의 테스트 용이성과 유지보수성을 크게 향상시킨다 [2, 3].

## 📖 Core Content
- **The Core Concept**:
    - 클래스 내부에서 `new Service()`를 호출하는 순간, 그 클래스는 해당 서비스에 강하게 결합(Coupled)된다.
    - DI는 생성자(Constructor)나 메서드 인자를 통해 외부에서 구현체를 전달받는다.
- **Benefits**:
    - **TeStability**: 실제 DB 대신 가짜(Mock) 객체를 주입하여 단위 테스트 가능.
    - **Flexibility**: 코드 수정 없이 실행 시점에 구현체 교체 가능.
    - **Maintenance**: 의존성 관리가 한곳(Container)으로 집중되어 구조 파악이 용이.
- **Types**: Constructor Injection, Setter Injection, Interface Injection.

---

### 1. 주요 주입 방식
*   **생성자 주입 (Constructor Injection):** 객체 생성 시점에 의존성을 주입받는 방식으로, 필드를 `final/readonly`로 유지할 수 있어 불변성을 보장하고 가장 권장되는 방식입니다.
*   **세터 주입 (Setter Injection):** 객체 생성 후 세터 메서드를 통해 의존성을 주입합니다. 선택적 의존성이 있거나 실행 중에 변경이 필요할 때 사용합니다.
*   **인터페이스 주입 (Interface Injection):** 주입을 담당하는 인터페이스를 통해 의존성을 제공받습니다. (상대적으로 사용 빈도가 낮음)

### 2. 제어의 역전 (IoC)과의 관계
DI는 **제어의 역전(Inversion of Control)**을 실현하는 구체적인 방법 중 하나입니다. 객체의 생성 주기와 의존성 조립의 권한을 객체 자신이 아닌 외부의 **IoC 컨테이너**(Spring의 ApplicationContext, NestJS의 Module 등)로 위임함으로써 개발자는 비즈니스 로직에만 집중할 수 있게 됩니다.

### 3. 실무 설계 패턴 (Frameworks)
*   **NestJS:** `@Injectable()`과 모듈 시스템을 통해 강력한 DI 컨테이너를 제공합니다. TypeScript의 타입을 토큰으로 활용하여 의존성을 자동 연결합니다.
*   **Spring Boot:** `@Autowired`나 생성자 주입을 통해 Bean 간의 의존성을 관리합니다.
*   **Riverpod (Flutter):** 상태 관리 기능에 DI를 결합하여 컴파일 타임 안정성을 제공하고 위젯 트리 외부에서 의존성을 안전하게 제공합니다.

---

---

- **결합도 감소 및 모듈화 촉진**
  의존성 주입은 모듈 간 상호작용 시 한 모듈이 다른 모듈의 인스턴스를 직접 생성하지 않고 외부에서 제공받는 방식을 취합니다 [1, 2]. 이러한 방식은 컴포넌트들을 디커플링(decoupling)하여 핵심 로직을 변경하지 않고도 구현체를 교체하거나 의존성을 쉽게 관리할 수 있게 해줍니다 [3].
- **의존성 역전 원칙(DIP) 구현의 핵심**
  객체 지향 프로그래밍의 핵심 설계 원칙 중 하나인 '의존성 역전 원칙(Dependency [[Inversion|Inversion]] Principle)'은 상위 모듈이 하위 모듈에 직접 의존하지 않고 둘 다 추상화에 의존해야 함을 명시합니다 [5]. 의존성 주입은 이 원칙을 실제로 구현하는 주된 수단으로 사용되며, Java의 Spring이나 ASP.NET Core와 같은 프레임워크들은 내장된 DI 컨테이너를 통해 의존성 주입을 훨씬 쉽게 구현할 수 있도록 지원합니다 [6].
- **소프트웨어 아키텍처에서의 활용**
  - **계층형 아키텍처(Layered [[Architecture|Architecture]]):** 상위 계층이 하위 계층을 직접 인스턴스화하는 대신 외부에서 의존성을 주입받게 하여, 계층 간의 느슨한 결합(loose coupling)을 이끌어냅니다 [1].
  - **클린 아키텍처(Clean Architecture):** 내부 계층에 정의된 인터페이스(포트)에 대해 외부 계층이 구체적인 구현(어댑터)을 제공합니다. 이때 런타임에 의존성 주입을 사용하여 컴포넌트들을 연결함으로써, 핵심 비즈니스 로직이 특정 프레임워크나 도구에 결합되지 않도록 방지합니다 [7]. 또한 의존성 주입기를 활용해 모든 의존성이 내부를 향하도록 의존성 규칙을 관리할 수 있습니다 [8].
- **테스트 용이성(TeStability) 확보**
  하드 코딩된 의존성은 구현 세부 사항과 강하게 결합하여 코드를 외부 환경으로부터 고립시켜 단위 테스트를 불가능하게 만들거나 어렵게 합니다 [4, 9]. 따라서 외부 시스템 없이 모듈을 독립적으로 테스트하고, 필요에 따라 목(Mock)과 같은 테스트 더블(Test Double)로 의존성을 대체하기 위해서는 의존성 주입의 사용이 필수적으로 권장됩니다 [4, 10].

---

* **구성 요소의 분리(Decoupling)와 유지보수성**: DI 프레임워크를 활용하면 시스템의 구성 요소들을 서로 분리(decouple)할 수 있다 [2]. 이를 통해 핵심 로직을 건드리지 않고도 의존성을 관리하거나 새로운 구현체로 대체하기가 훨씬 수월해지며, 결과적으로 시스템의 테스트 가능성(Testability)과 유지보수성이 현저히 향상된다 [2].
* **의존성 역전 원칙(DIP)의 실현**: 상위 수준 모듈이 하위 수준 모듈에 직접 의존하지 않고 양쪽 모두 추상화(abstractions)에 의존해야 한다는 '의존성 역전 원칙(Dependency Inversion Principle)'은 주로 의존성 주입(DI)을 통해 구현된다 [3]. Java의 Spring이나 ASP.NET Core에 내장된 DI 컨테이너와 같은 프레임워크를 사용하면 구성 요소를 쉽게 분리하여 이 원칙을 적용할 수 있다 [4].
* **계층형 아키텍처(Layered Architecture) 내에서의 역할**: 계층 간의 엄격한 통신을 강제하고 종속성을 관리하기 위해 DI를 구현한다 [1]. 상위 계층이 하위 계층의 객체를 직접 생성하는 방식 대신, 외부 소스로부터 의존성이 주입되게 함으로써 결합도를 느슨하게 만든다 [1]. 
* **클린 아키텍처(Clean Architecture)와의 결합**: 비즈니스 로직을 외부의 데이터베이스나 웹 프레임워크로부터 격리시키는 클린 아키텍처에서 DI는 필수적으로 사용된다 [5, 6]. 내부 계층에서 인터페이스(포트)를 정의하고 외부 계층이 구체적인 구현체(어댑터)를 제공하도록 설계한 뒤, 런타임 시점에 의존성 주입을 사용해 이 구성 요소들을 연결한다 [6].

## ⚖️ Trade-offs & Caveats
- DI 프레임워크(Spring, NestJS 등)를 과도하게 사용하면 의존성 그래프가 너무 복잡해져 런타임 성능에 영향을 주거나 디버깅이 어려워지는 'DI 지옥'에 빠질 수 있다. 객체 간의 관계가 명확할 때는 과도한 추상화보다 직관적인 구성을 고려해야 한다.

---

### ✅ Benefits
*   **낮은 결합도:** 객체 간의 직접적인 참조가 줄어들어 특정 구현체가 변경되어도 이를 사용하는 코드를 수정할 필요가 없습니다.
*   **테스트 용이성:** 실제 DB나 API 객체 대신 Mock(가짜) 객체를 외부에서 주입하여 독립적인 단위 테스트가 가능합니다.
*   **유지보수성:** 객체의 생성 로직이 한곳(Composition Root)에 모여 있어 시스템 구성 파악이 용이합니다.

### ⚠️ Challenges
*   **초기 복잡성:** 단순한 프로젝트에서는 인터페이스 정의와 프레임워크 설정 등이 오버헤드가 될 수 있습니다 (Overkill).
*   **런타임 오류:** 의존성이 런타임에 주입되므로, 설정 오류로 인한 주입 실패를 컴파일 시점에 발견하기 어려울 수 있습니다 (단, 최신 프레임워크는 이를 상당 부분 개선함).
*   **코드 추적의 어려움:** 객체 생성 로직이 외부에 감추어져 있어, 코드를 처음 읽는 개발자가 실제 어떤 클래스가 사용되는지 파악하기 위해 미로를 헤매는 현상(The Hidden Maze)이 발생할 수 있습니다.

---

---

- **과거 데이터와의 충돌:** 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
- **정책 변화:** Programming & Language 분야의 자동 자산화 수행.

---

DI 메커니즘 자체로 인해 발생하는 런타임 오버헤드, 디버깅 복잡성 등의 구체적인 기술적 제약 사항이나 부작용에 대해서는 **소스에 관련 정보가 부족합니다**. 

다만, DI를 포함한 SOLID 원칙 및 아키텍처 패턴을 코드베이스에 적용할 때 따르는 설계적 측면의 제약(Trade-off)과 요구 사항은 다음과 같습니다:
* **숙련도 및 프레임워크 의존성**: DI를 원활하게 구현하기 위해서는 Spring이나 ASP.NET Core와 같은 전용 DI 프레임워크 기술에 의존해야 하며, 이를 능숙하게 다룰 수 있는 숙련된 개발자(Skilled developers)가 필요하다 [4, 7].
* **선행 설계 작업의 증가**: 핵심 구현 코드를 작성하기 전에 컴포넌트가 무엇을 해야 하는지 정의하는 '인터페이스 설계'를 먼저 수행해야 하는 설계 규율(design discipline)이 강제된다 [4, 7].
* **구현 복잡도(Implementation Complexity)**: 컴포넌트의 책임을 분리하고 추상화하는 과정은 초기 설계 및 리팩토링 단계에서 중간에서 높음(Medium-High) 수준의 작업 복잡도와 설계 훈련을 요구한다 [7].

## 🔗 Knowledge Connections
- Related: [[의존성 역전 (Dependency Inversion)|Dependency-[[Inversion]]-Principle]] , Inversion-of-Control (IoC)
- Pattern: Factory-Method-Pattern

---

### Related Concepts
*   [[Dependency_Inversion_Principle]]: DI가 추구하는 근본적인 객체지향 설계 원칙입니다.
*   [[Hexagonal_Architecture]]: 도메인 포트에 외부 어댑터를 주입할 때 DI를 필수로 사용합니다.
*   [[Inversion_of_Control]]: 객체의 생명 주기를 프레임워크에 위임하는 상위 개념입니다.

### Practical Application Contexts
*   **Unit Testing:** 테스트 환경에서 Mock Repository를 주입하여 비즈니스 로직을 검증합니다.
*   **Polyglot Infrastructure:** 설정 파일만 변경하여 SQL DB 어댑터를 NoSQL DB 어댑터로 교체합니다.

---

---

- **Related Topics:** [[의존성 역전 원칙 (Dependency Inversion Principle)|의존성 역전 원칙 (Dependency Inversion Principle]], 느슨한 결합 (Loose Coupling), 관심사의 분리 ([[_뇌와 팔다리의 분리_ - 관심사의 분리 (Separation of Concerns)|Separation of Concerns]], [[테스트 용이성 (Testability)|테스트 용이성 (Testability]]
- **Projects/Contexts:** [[클린 아키텍처 (Clean Architecture)|클린 아키텍처 (Clean Architecture]], 계층형 아키텍처 (Layered Architecture), [[Spring Framework|Spring Framework]], ASP.NET Core
- **Contradictions/Notes:** 제공된 모든 소스는 의존성 주입이 모듈 간의 결합도를 낮추고 테스트 용이성을 극대화한다는 점에서 일치된 견해를 보이고 있으며, 코드의 설계 단계부터 하드 코딩을 지양하고 의존성 주입을 염두에 둘 것을 공통적으로 강조하고 있습니다 [2, 9].

---
*Last updated: 2026-04-18*

---

---

### Related Concepts

#### [설계 원칙 (Design Principles)]
- [[의존성 역전 원칙 (Dependency Inversion Principle, DIP)]]
  - 연결 이유: DI는 고수준 모듈과 저수준 모듈 간의 결합을 끊기 위해 추상화에 의존하게 만드는 DIP 원칙을 코드로 구현하는 직접적인 수단이다 [3].
  - 이 개념을 통해 더 깊게 이해할 수 있는 부분: 왜 인터페이스를 구현체보다 먼저 설계해야 하는지, 그리고 DI가 어떻게 코드의 유연성을 확보하는지 그 근본적인 철학을 이해할 수 있다 [3, 4].

- [[관심사의 분리 (Separation of Concerns, SoC)]]
  - 연결 이유: 시스템을 겹치지 않는 별개의 기능 섹션으로 분할하여 복잡도를 낮추는 SoC를 실무적으로 효과적으로 적용하기 위한 핵심 전략 중 하나가 DI 프레임워크를 활용하는 것이다 [2, 8].
  - 이 개념을 통해 더 깊게 이해할 수 있는 부분: 의존성 주입이 궁극적으로 모듈성(Modularity)을 높이고 시스템 복잡도를 줄이는 거시적 설계 목표와 어떻게 맞닿아 있는지 파악할 수 있다 [2, 8].

#### [아키텍처 및 구현 기술 (Architectures & Frameworks)]
- [[클린 아키텍처 (Clean Architecture)]]
  - 연결 이유: 비즈니스 로직(내부)과 프레임워크/데이터베이스(외부)를 격리하기 위한 의존성 규칙을 런타임에 최종적으로 완성시키는 도구가 바로 DI이다 [5, 6].
  - 이 개념을 통해 더 깊게 이해할 수 있는 부분: 포트(인터페이스)와 어댑터(구현체)가 코드 구조 내에서 분리되어 있을 때, 어떻게 이들이 실제 애플리케이션 실행 시 결합되는지 그 연결 고리를 이해할 수 있다 [6].

- [[DI 프레임워크 (Spring, ASP.NET Core)]]
  - 연결 이유: 의존성 주입을 수동으로 관리하는 대신, 시스템 차원에서 자동으로 객체를 생성하고 주입해 주는 실질적인 구현 도구들이다 [4].
  - 이 개념을 통해 더 깊게 이해할 수 있는 부분: 코드베이스 내부에서 종속성 관계를 자동으로 조립하고 분리(decouple)하는 구체적인 프레임워크의 동작 방식을 이해할 수 있다 [4].

### Deeper Research Questions
- 의존성 주입 시 인터페이스와 구체 클래스(Concrete Implementation)를 연결하는 설정 정보는 대규모 코드베이스의 어느 계층(혹은 모듈)에 위치하는 것이 가장 이상적인가?
- 런타임에 동적으로 의존성이 주입되는 환경에서, 상향식(Bottom-Up) 코드베이스 탐색 시 데이터 흐름과 의존 관계를 어떻게 효과적으로 역추적할 수 있는가?
- 의존성 주입 프레임워크(예: Spring)를 과도하게 사용할 때 발생할 수 있는 '코드 가독성 저하'나 '디버깅의 어려움'을 해결하기 위한 구조적 접근법은 무엇인가?
- 마이크로서비스 아키텍처(MSA)에서 각 독립된 서비스 내부의 DI 컨테이너 구성은 모놀리식 아키텍처와 비교하여 어떤 차별화된 설계 전략을 가져야 하는가?
- 테스트 자동화를 위해 단위 테스트에서 모의 객체(Mock Objects)를 의존성 주입으로 제공할 때, 테스트 커버리지를 높이는 가장 효율적인 인터페이스 분리 전략은 무엇인가?

### Practical Application Contexts

- **Implementation:** 클래스 개발 시 내부에서 사용할 의존 객체를 직접 `new` 키워드로 생성하지 않고, 생성자나 설정자를 통해 주입받도록 코드를 작성한다. 또한, 코드 구현에 앞서 인터페이스를 먼저 정의하여 의존성의 유연함을 확보한다 [1, 4].
- **System Design:** 소프트웨어 아키텍처를 계층형(Layered) 또는 클린 아키텍처로 구성할 때, 하위 계층의 변경이 상위 계층에 영향을 미치지 않도록 계층 간 통신 경계 인터페이스를 구축하고 이를 DI로 연결하도록 설계한다 [1, 6].
- **Operation / Maintenance:** 데이터베이스 기술 교체나 새로운 외부 API 연동이 필요할 때, 핵심 비즈니스 로직 모듈은 그대로 유지한 채 DI 컨테이너의 설정만 수정하여 외부 어댑터 구현체를 교체함으로써 유지보수 비용을 최소화한다 [2, 5, 6].
- **Learning Path:** SOLID 원칙 중 SRP(단일 책임 원칙) 적용을 시작으로 인터페이스 설계법을 익히고, DIP의 개념을 숙지한 뒤, Spring이나 ASP.NET Core 등의 DI 프레임워크의 사용법을 학습하는 순서로 확장해 나간다 [4].
- **My Project Relevance:** 복잡한 시스템의 '코드베이스 읽기 지식'을 확보하기 위해 소스 코드를 탐색할 때, 객체가 직접 생성되지 않고 주입되는 패턴(DI)을 인지함으로써, 정적 코드만으로는 보이지 않는 런타임 시점의 결합 구조와 전체 실행 제어 흐름(Control Flow)을 정확히 해독하고 역추적하는 데 필수적이다 [2, 4].

### Adjacent Topics
- [[테스트 가능성 (Testability)]]
  - 확장 방향: DI가 어떻게 모의 객체(Mock)나 스텁(Stub) 주입을 용이하게 만들어 단위 테스트를 격리된 환경에서 안전하고 완벽하게 수행할 수 있도록 돕는지 확장하여 조사한다 [1, 2].

---
*Last updated: 2026-05-02*


## 💡 Adjacent Topics
*   [[NestJS]]: DI를 기반으로 아키텍처를 강제하는 대표적인 Node.js 프레임워크입니다.
*   [[Composition_Root]]: 애플리케이션 진입점에서 모든 객체 의존성을 조립하는 지점입니다.
*   [[Service_Locator_Pattern]]: DI와 유사하지만 객체가 직접 저장소를 호출하여 의존성을 찾는, 지양해야 할 안티패턴입니다.

---
*Last updated: 2026-05-02*