FastAPIでpath operation関数のDependsが実行されるのは、リクエストごと

はじめに

エミもふ白菜さん nikkieです。

FastAPIでDBのセッションをDependsで渡すのを見ます¹。
これがリクエストごとに実行されていることを、簡単な例で確認しました。

目次

• はじめに
• 目次
• Tutorial「Dependencies」の例
• typing.Annotated
• 終わりに

Tutorial「Dependencies」の例

path operation関数²が依存するパラメタを引数で注入する例です。
2つのpath operation関数に共通する依存を注入しています

Dependsに渡す関数にprintを仕込みました。
呼び出されるタイミングを確認する意図です。

% uv version
uv 0.5.17 (Homebrew 2025-01-10)
% uvx --with 'fastapi[standard]' fastapi dev first_steps.py

% curl http://127.0.0.1:8000/items/
{"q":null,"skip":0,"limit":100}

common_parameters called
      INFO   127.0.0.1:54804 - "GET /items/ HTTP/1.1"
             200

% curl http://127.0.0.1:8000/users/
{"q":null,"skip":0,"limit":100}

common_parameters called
      INFO   127.0.0.1:54818 - "GET /users/ HTTP/1.1"
             200

リクエストのたびにcommon_parametersが呼び出されていることが分かります。
それぞれのパスに複数回リクエストを送って確認しています。

typing.Annotated

CommonsDep = Annotated[dict, Depends(common_parameters)]

https://docs.python.org/ja/3/library/typing.html#typing.Annotated

Add metadata x to a given type T by using the annotation Annotated[T, x].

これは型にメタデータを与えるものでした。
common_parametersの例では、dict型にDepends(common_parameters)というメタデータを与えています。

仕組みはいまは見当がつかず、まるで魔法のようですが、FastAPIのDependsはメタデータの関数を実行して返り値を注入しているのですね。

終わりに

FastAPIでDependsに指定した関数が、path operation関数を呼び出すごと（＝リクエストごと）に実行されることを確認しました。
DependsでDBセッションを渡す場合、リクエストごとにセッションが作られるということですね³