dependency injection(Depends)은 어떻게 동작합니까?

Question

Accepted Answer

FastAPI의 **dependency injection** 시스템은 재사용 가능한 의존성(함수/클래스)을 선언하면, FastAPI가 이를 호출하여 `Depends()`를 통해 경로 작업에 **주입(inject)**하도록 합니다. 데이터베이스 세션, 인증, 공통 매개변수 같은 공유 로직에 사용되어 코드를 DRY하고 테스트 가능하게 유지합니다.

## 기본 의존성

```python
from fastapi import Depends

# 의존성은 단지 무언가를 반환하는 호출 가능 객체(callable)입니다
def pagination(skip: int = 0, limit: int = 10):
    return {"skip": skip, "limit": limit}

@app.get("/items")
def list_items(params: dict = Depends(pagination)):   # FastAPI가 pagination()을 호출하고 결과를 주입
    return params
# skip/limit 쿼리 매개변수가 이제 재사용 가능한 의존성에 의해 처리됩니다
```

`params = Depends(pagination)`을 선언하면 FastAPI가 `pagination`을 호출하고(그 매개변수도 요청에서 해결), 결과를 함수에 전달하도록 지시합니다. 의존성은 여러 엔드포인트에서 재사용 가능합니다.

## 정리(cleanup)가 있는 의존성(yield) — 예: 데이터베이스 세션

```python
def get_db():
    db = SessionLocal()
    try:
        yield db                  # 엔드포인트에 세션 제공
    finally:
        db.close()                # 응답 후 정리 실행 — 보장됨

@app.get("/users")
def list_users(db = Depends(get_db)):
    return db.query(User).all()    # 주입된, 자동으로 닫히는 세션 사용
```

`yield` 의존성은 리소스를 제공하고 요청 후 정리(teardown)를 실행합니다. 데이터베이스 세션의 표준 패턴입니다(이전에 열고, 이후에 자동으로 닫음).

## 의존성은 다른 의존성에 의존할 수 있습니다

```python
def get_current_user(token: str = Depends(get_token)):   # 다른 의존성에 의존
    return decode(token)

@app.get("/me")
def me(user: User = Depends(get_current_user)):           # 주입을 통한 인증
    return user
```

의존성은 트리를 형성하며 FastAPI가 전체 체인을 해결합니다. 인증은 일반적으로 이렇게 처리됩니다(`get_current_user` 의존성).

## 클래스 의존성과 재사용

```python
@app.get("/items", dependencies=[Depends(verify_api_key)])   # 반환값을 사용하지 않고 의존성 실행
def items(): ...                                              # 예: 부수 효과로 인증 강제
```

## 왜 중요한가

dependency injection은 FastAPI의 가장 강력하고 중요한 기능 중 하나입니다. 엔드포인트 전반에서 로직(데이터베이스 세션, 인증, 공통 쿼리 매개변수, 권한 검사)을 중복 없이 깔끔하게 공유하고 재사용하는 방법입니다.

이를 이해하는 것이 필수적인 이유는 핵심 패턴의 기반이 되기 때문입니다: **`yield` 의존성**은 데이터베이스 세션을 관리하는 표준 방법이며(각 요청 후 보장된 정리와 함께), **`get_current_user` 의존성**은 인증을 구현하는 관용적인 방법입니다.

DI는 또한 코드를 매우 **테스트 가능**하게 만듭니다. 테스트에서 의존성을 목(mock)으로 재정의할 수 있습니다.

이 시스템의 우아함(의존성이 요청에서 자체 매개변수를 해결하고, 다른 의존성에 의존하여 트리를 형성하며, 문서와 통합됨)은 실제 애플리케이션 구조화를 위한 다재다능한 도구로 만듭니다. 따라서 `Depends`를 익히는 것은 잘 구성되고 유지보수 가능하며 테스트 가능한 FastAPI 앱을 구축하는 데 핵심입니다.