Postmortem: SD WebUI Forge xformers 依存関係崩壊¶

📁 docs/ops/postmortem/2026-03-11_SD-Forge-xformers依存関係崩壊.md

概要¶

発生日時: 2026-03-08 頃（推定）
検知日時: 2026-03-08〜11（起動失敗で気づく）
解消日時: 2026-03-11
ダウンタイム: 約 3 日

影響範囲¶

システム: SD WebUI Forge（D:\Kazuma_Teramachi\kaz_dev_stable-diffusion-webui-forge）
影響内容: Forge が起動不可。AI 漫画・LoRA 学習のすべての画像生成が停止
影響期間: 2026-03-08 〜 2026-03-11

タイムライン¶

日時	出来事
2026-03-08 頃	`pip install --upgrade` 実行後に Forge 起動不可
2026-03-08〜10	CUDA エラー・xformers 起動失敗で原因調査
2026-03-11	PyTorch 2.7.0+cu128 + xformers 0.0.30 の正常バージョン組み合わせを特定・修正
2026-03-11	Forge 正常起動を確認

原因¶

直接原因¶

pip install --upgrade xformers を実行したところ、xformers が RTX 5070 Ti（Blackwell / sm_120）に対応した PyTorch 2.7.0+cu128 と非互換なバージョン（0.0.31+）にアップグレードされ、起動時に CUDA エラーが発生した。

根本原因¶

PyTorch（+cu128）と xformers はメジャーバージョンが 1:1 対応しているが、この依存関係が requirements.txt 等でピン留めされていなかった
RTX 5070 Ti（Blackwell / sm_120）は PyTorch 2.7.0+cu128 が必須であり、一般的な +cu121 や +cu124 パッケージでは動作しない特殊な環境だった

修正内容¶

# 正常な組み合わせに戻す
pip install torch==2.7.0+cu128 torchvision==0.22.0+cu128 torchaudio==2.7.0+cu128 \
    --index-url https://download.pytorch.org/whl/cu128

pip install xformers==0.0.30 --index-url https://download.pytorch.org/whl/cu128

再発防止策¶

対策	担当	状態
xformers アップグレード時は必ず torch/torchvision/torchaudio をセットで更新する	手動	✅ CLAUDE.md memory に記録済み
対応バージョン表をドキュメント化	Claude	✅ 完了（下記参照）

バージョン対応表¶

xformers	PyTorch
0.0.30	2.7.0
0.0.31	2.7.1
0.0.32	2.8.0
0.0.33	2.9.0
0.0.34	2.10.0
0.0.35	≥2.10

学んだこと¶

RTX 5070 Ti（Blackwell）環境では +cu128 パッケージが必須。一般ガイドの +cu121 や +cu124 は使えない
pip install --upgrade を単体で実行すると PyTorch ↔ xformers の整合性が壊れる
アップグレードは必ず torch + torchvision + torchaudio + xformers をセットで実施する