FastAPIアプリケーションをどのようにテストしますか？

Question

Accepted Answer

FastAPIは、その**`TestClient`**（Starlette/httpxの上に構築されている）と、依存性のモック化を簡単にする**依存性注入**システムのおかげで、非常にテストしやすいフレームワークです。テストは通常、`pytest`と`TestClient`を使って、サーバを起動せずにアプリへリクエストを送信します。

## TestClientによる基本的なエンドポイントのテスト

```python
from fastapi.testclient import TestClient
from main import app

client = TestClient(app)

def test_read_item():
    response = client.get("/items/5")            # send a request to the app in-process
    assert response.status_code == 200
    assert response.json() == {"item_id": 5}

def test_create_item():
    response = client.post("/items", json={"name": "Phone", "price": 999})
    assert response.status_code == 201
    assert response.json()["name"] == "Phone"

def test_validation_error():
    response = client.post("/items", json={"name": "Phone"})   # missing price
    assert response.status_code == 422                          # FastAPI validates automatically
```

`TestClient`は、アプリへ実際のリクエストをインプロセスで送信する（サーバ不要）ため、ルーティング、バリデーション、シリアライズといったフロー全体をテストでき、ステータスコードとJSONレスポンスをアサートできます。

## 依存性のオーバーライド（クリーンなテストの鍵）

```python
# override a dependency with a mock/test version — no real database needed
def override_get_db():
    return test_db_session

app.dependency_overrides[get_db] = override_get_db   # swap the real dependency

def test_with_test_db():
    response = client.get("/users")
    # uses the test database via the override
    app.dependency_overrides.clear()                 # reset after
```

FastAPIの`dependency_overrides`を使うと、**任意の依存性**（データベースセッション、認証、外部サービス）をテストダブルに**置き換える**ことができます——これは高速で隔離されたテストの基盤であり、DIの設計によって簡単に実現できます。

## 保護されたエンドポイントのテスト

```python
def test_protected():
    # override the auth dependency to simulate a logged-in user
    app.dependency_overrides[get_current_user] = lambda: fake_user
    response = client.get("/me")
    assert response.status_code == 200
```

## テスト戦略

```text
✓ Use a TEST database (separate, or transactions rolled back per test)
✓ Override dependencies (DB, auth, external APIs) for isolation
✓ Test: status codes, response shapes, validation (422s), auth/permissions, edge cases
✓ For async-specific code, use httpx.AsyncClient / pytest-asyncio
✓ Tools: pytest, factory libraries for test data, coverage.py
```

## なぜ重要なのか

テストは信頼性の高いアプリケーションにとって不可欠であり、FastAPIは際立ってテストしやすいフレームワークです——テスト方法を理解しておくことは、コード品質のためにも、フレームワークがテスト容易性を*念頭に置いて設計されている*という点からも重要です。

**`TestClient`**を使えば、リクエスト/レスポンスのフロー全体をインプロセスで簡単にテストでき（サーバ不要）、クライアントが実際に体験するのと同じようにルーティング、バリデーション、シリアライズ、レスポンスを検証できます。

際立った特徴は**依存性のオーバーライド**です。FastAPIは依存性注入を使うため、`app.dependency_overrides`を通じて任意の依存性——データベースセッション、認証、外部サービス——をテストダブルに簡単に置き換えることができ、実際のインフラなしで高速かつ隔離されたテストが可能になります（このテスト容易性はDI設計の大きな利点です）。

TestClientの使い方、隔離のための依存性のオーバーライド（テスト用データベース、モック化された認証/サービス）、保護されたエンドポイントのテスト、そして賢明なテスト戦略の構築（ステータスコード、レスポンスの形、バリデーション、認証、エッジケース）を知っておくことは、堅牢なFastAPIアプリケーションを構築するための重要なシニアレベルの知識です。

よくテストされたAPIはリグレッションを捕捉し、自信を持ったリファクタリングを可能にします。そしてFastAPIのテストツールは徹底したテストを容易にするため、これは頻繁に関係し、専門的に重要なトピックです。