Depends

Date

2026/03/23

Dependency Injection

의존성 주입은 프로그램 각 구성 요소가 서로 강하게 결합되는 것을 피하기 위해 사용하는 디자인 패턴이다. 보통 서비스 로직은 데이터 접근 로직과 같은 특정 모듈에 의존하게 되는데, 이는 시스템의 유지보수성을 떨어뜨리고 확장 가능성을 제한한다. 이를 해결하기 위해 의존성 주입은 구체적인 구현체 대신 추상화된 인터페이스에 의존하도록 하여 유연성을 높인다.

Depends()

FastAPI에서는 Depends() 함수를 통해 DIP를 구현한다.

from typing import Annotated

from fastapi import Depends, FastAPI

app = FastAPI()


async def common_parameters(q: str | None = None, skip: int = 0, limit: int = 100):
    return {"q": q, "skip": skip, "limit": limit}


@app.get("/items/")
async def read_items(commons: Annotated[dict, Depends(common_parameters)]):
    return commons


@app.get("/users/")
async def read_users(commons: Annotated[dict, Depends(common_parameters)]):
    return commons
Python
복사

만약 read_users 함수에서 Depends 없이 함수 내부에 그대로 작성했다면, common_parameters 내부의 리턴 값이 바뀌었을 때 read_users함수의 내용도 바뀌었을 것이다.

하지만, 이를 구현체에만 의존하게끔 의존성을 주입시켰다.

이렇게 하면 코드의 반복이 줄고, 재사용 가능성이 커진다는 장점이 생긴다.

클래스로 사용

기존에 함수로 사용하는 방식도 있지만, Depends함수 내에 인자로 클래스를 선언했다.

from typing import Annotated

from fastapi import Depends, FastAPI

app = FastAPI()


fake_items_db = [{"item_name": "Foo"}, {"item_name": "Bar"}, {"item_name": "Baz"}]


class CommonQueryParams:
    def __init__(self, q: str | None = None, skip: int = 0, limit: int = 100):
        self.q = q
        self.skip = skip
        self.limit = limit


@app.get("/items/")
async def read_items(commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]):
    response = {}
    if commons.q:
        response.update({"q": commons.q})
    items = fake_items_db[commons.skip : commons.skip + commons.limit]
    response.update({"items": items})
    return response
Python
복사

FastAPI 에서는 이렇게 하면 해당 클래스의 "인스턴스"가 생성되고 인스턴스가 commons함수에 매개변수로 전달된다.

이때, commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)] 이 부분에서 CommonQueryParams 의존성이 중복되기 때문에 축약하는 방법을 제공한다.

commons: Annotated[CommonQueryParams, Depends()]

→ 어노테이션 없는 버전: commons: CommonQueryParams = Depends()

의존성을 매개변수의 유형으로 선언하고 내부에 전체 클래스를 다시 작성하지 않아도 Depends()를 쓰는걸로 매개변수 없이 사용할 수 있다.

Reference

Python FastAPI 의존성 주입 (Depends 함수)

파이썬에서 의존성 주입은 Depends 함수를 통해 실행된다. 1. 의존성 주입이 뭔데? A라는 코드가 있고, B라는 코드가 있다고 하자. A는 반드시 B가 실행되어야 실행되는 흐름이라고 한다면, A와 B는 의존관계라고 할 수 있다. A를 상위계층이고, B를 하위계층

https://velog.io/@munang/Python-FastAPI-%EC%9D%98%EC%A1%B4%EC%84%B1-%EC%A3%BC%EC%9E%85-Depends-%ED%95%A8%EC%88%98

Dependencies - FastAPI

FastAPI framework, high performance, easy to learn, fast to code, ready for production

https://fastapi.tiangolo.com/tutorial/dependencies/