CR-NEXUS-035: DetachedInstanceError 解消 - 完了レポート

実装日時

2025年12月24日

tests/api/test_external_api_smoke.py で発生している sqlalchemy.orm.exc.DetachedInstanceError（setup error）を解消する。

確認した問題:

tests/conftest.py の test_project fixture が owner_id=test_user.id を参照した時点で DetachedInstanceError が発生
test_user が SQLAlchemy Session にバインドされていない（もしくは expire されている）状態で .id にアクセスしていた
異なる app_context 間で ORM インスタンスを参照することが原因

発生箇所:

変更ファイル:

修正内容:

test_user_id fixture を追加:
- ORM インスタンスではなく、安定した int の user_id を返す fixture を追加
- test_user fixture とは独立して User を作成し、id のみを返す
- 既存の User が存在する場合は再利用
test_project_id fixture を追加:
- ORM インスタンスではなく、安定した int の project_id を返す fixture を追加
- 既存の Project が存在する場合は再利用
既存 fixture の修正:
- test_project: test_user.id → test_user_id を使用
- test_run_with_metrics: test_project.id, test_user.id → test_project_id, test_user_id を使用
- test_run_with_self_healing_metrics: 同様に修正
- test_api_key: test_user.id → test_user_id を使用

設計方針:

実行コマンド:

python -m pytest tests/api/test_external_api_smoke.py -q

結果:

ERROR（setup error）: 0 件（以前は 6 件）
7 件の failed がありますが、これらは DetachedInstanceError による setup error ではなく、テストの失敗（404エラーなど）です。これらは CR-NEXUS-035 のスコープ外です。

Fixture の安定性向上
- ORM インスタンスではなく int の id を返す fixture パターンを確立
- DetachedInstanceError を根本的に回避する設計