Question 1

OTEL_EXPORTER_OTLP_ENDPOINT が設定されていると FastAPI 0.142.0 の起動が失敗するのはなぜですか?また、どのように修正すればよいですか?

Accepted Answer

これは FastAPI 0.142.0 のバグです。`OTEL_EXPORTER_OTLP_ENDPOINT` 環境変数が設定されている（ホスティングプラットフォームでは一般的）にもかかわらず、OpenTelemetry エクストラがインストールされていない場合、アプリは起動時に「Automatic OpenTelemetry export requires fastapi[opentelemetry]」というエラーでクラッシュします。**修正方法: FastAPI 0.142.2 以降にアップグレードしてください**。これによりこの問題が解決されます（PR #16418）。0.142.0 を使い続けなければならない場合の代替的な回避策: (1) `pip install fastapi[opentelemetry]` または `fastapi[standard]` でエクストラをインストールする、(2) `FastAPI()` に `telemetry={'auto_configure': False}` を渡して自動設定を無効にする、(3) FastAPI 0.141.0 にダウングレードする。

Question 2

FastAPI の generate_unique_id_function で "Object of type 'APIRoute' has no attribute 'tags'" という型チェッカーエラーを修正するには？

Accepted Answer

これは FastAPI 0.137.0 における型アノテーションのリグレッションで（PR #15745 で導入されたもの）、`APIRoute` がクラスレベルの `tags` アノテーションを失ったため、型チェッカー（ty、Pyright strict）がカスタム `generate_unique_id_function` 内の `route.tags` に対して `unresolved-attribute` を報告します — コードは実行時には正常に動作するにもかかわらず。修正方法：アノテーションが復元された FastAPI 0.137.1 以降にアップグレードしてください（PR #15765）:

```bash
pip install -U "fastapi>=0.137.1"
```

これにより、ドキュメントに記載されているパターンが正しく型チェックを通過します:

```python
from fastapi import FastAPI
from fastapi.routing import APIRoute

def custom_generate_unique_id(route: APIRoute) -> str:
    return f"{route.tags[0]}-{route.name}"

app = FastAPI(generate_unique_id_function=custom_generate_unique_id)
```

一時的に 0.137.0 を使い続けなければならない場合は、`route.tags` の行に `# type: ignore[attr-defined]` コメントを付けてエラーを抑制するか、`getattr(route, "tags", [])` 経由でアクセスしてください。

Question 3

ルーターが include された後に、FastAPI の APIRouter.routes に直接追加されたルートが 404 を返す（また、削除されたルートが依然として応答する）のはなぜですか？

Accepted Answer

FastAPIは（ルーターインクルードの遅延化リライト以降、#15745）、インクルードされた各ルーターの解決済みルートを、内部のバージョンカウンター（`APIRouter._routes_version`）をキーとしてキャッシュします。`append()`、`remove()`、`clear()`、スライス代入、再代入で`router.routes`を直接変更しても、そのカウンターは一切更新されないため、親ルーターは古いキャッシュ済みリストを使い続けます。新しいルートは404を返し、削除されたルートは「ゴースト」ルートとして応答し続けます。

回避策：
1. キャッシュを正しく無効化する、追跡対象の公式メソッド経由でのみルートを変更してください：
   ```python
   # child.routes.append(APIRoute("/child2", handler, methods=["GET"])) の代わりに
   child.add_api_route("/child2", handler, methods=["GET"])
   # または: child.add_route(...), child.include_router(...)
   ```
2. `router.routes`を直接変更しなければならない場合（例：ルートを削るために`app.router.routes = [...]`とする場合）、直後に手動でキャッシュを無効化してください：
   ```python
   child.routes.append(new_route)
   child._mark_routes_changed()  # プライベートAPI。将来のリリースで変更される可能性があります
   ```
3. キャッシュは最初のディスパッチ時にのみ構築されるため、直接の変更はすべて、ルーターがインクルードされる前、かつアプリが最初のリクエストを処理する前に実行してください。

`.routes`の変更を検知できるようにする正式な修正が、fastapiのissue #16301で議論されています。

Question 4

なぜFastAPIのiter_route_contexts()はWebSocketルートに対して空のパスを返すのですか？

Accepted Answer

これは FastAPI 0.137.2 以降で確認されたバグです（0.141.1 でも依然として存在します）: iter_route_contexts() は HTTP ルートには include_router() のプレフィックスを適用しますが、APIWebSocketRoute に対しては ctx.path == "" を返し、ctx.route.path にはプレフィックスの付かないパスのみが保持されます。修正済みのリリースはまだ存在しません。回避策: WebSocket ルートを個別に特別扱いし、include_router() に渡したプレフィックスを先頭に付与して、完全なパスを自分で再構築してください。

```python
from fastapi.routing import APIWebSocketRoute, iter_route_contexts

PREFIX = "/api/v1"  # the prefix used in app.include_router(router, prefix=PREFIX)

for ctx in iter_route_contexts(app.routes):
    if isinstance(ctx.route, APIWebSocketRoute) and not ctx.path:
        full_path = PREFIX + ctx.route.path  # e.g. /api/v1/stream/{job_id}
    else:
        full_path = ctx.path
```

プレフィックスを静的に把握できない場合、それはプライベートな _IncludedRouter.include_context.prefix に格納されていますが、この API は内部向けであり変更される可能性があるため、修正がリリースされるまでは include_router() のプレフィックスを自分で追跡しておく方が安全な選択肢です。

fastapi

概要

README プレビュー

FAQ (4)

同类型项目

tensorflow

superpowers

everything-claude-code

flutter