タグ広場 V1 /posts/changes の非 admin アクセス時 503 を修正 #485

オープン
みてるぞが2026-11-18 20:38:11 +09:00に作成 · 3件のコメント
オーナー

対象

  • リポジトリ:btrc-hub(V1)
  • 対象画面:/posts/changes(locale prefix 付き URL を含む)
  • 症状:admin では表示できるが、member・guest では HTTP 503 が発生する。
  • 原因の仮説:非 admin の履歴公開判定を伴う SQL が重く、SSR から Rails API へのアクセスがタイムアウトしている。

本番環境での原因は未確定。仮説を検証してから修正すること。

調査対象ファイル

  • backend/app/models/history_access.rb
  • backend/app/controllers/post_versions_controller.rb
  • backend/spec/requests/post_history_privacy_spec.rb
  • frontend/src/lib/api.ts
  • frontend/src/lib/prefetchers.ts
  • frontend/src/lib/prefetchers.test.ts
  • frontend/src/lib/posts.ts
  • frontend/src/pages/posts/PostHistoryPage.tsx
  • frontend/server.mjs

必要に応じて関連モデル、migration、index 定義、テストも調査すること。

1. 原因調査

1.1 権限による SQL の相違

HistoryAccess.sql() は admin に対して TRUE を返すが、それ以外では複雑な履歴公開判定を生成する。

次を重点的に調査する。

  • event_type = 'discard' に基づく履歴境界判定
  • GROUP BY / MAX(version_no) を使った集約
  • NOT EXISTS の相関条件
  • JSON_TABLE を使ったタグ・外部タグ参照の検証
  • 親投稿とタグ履歴の参照検証
  • snapshot_reference() で行う追加の履歴照会
  • 複合 index の有無と利用可能性

DB の実行計画を確認可能な環境では EXPLAIN 等でボトルネックを特定する。高負荷になり得る計測を本番 DB に無断で実行しないこと。

1.2 全件 count

PostVersionsController#index には次の処理がある。

count = q.except(:select, :order, :limit, :offset).count

非 admin では HistoryAccess.visible() が適用された状態で全件集計される。

この count が主なボトルネックになっていないか確認すること。

また、ページ取得用の pluck と、その後の version_scope.merge(q) による取得についても、不要な条件の再評価や過剰な JOIN が発生していないか確認する。

1.3 SSR

frontend/src/lib/api.ts では SSR 時の API timeout が10秒に設定されている。

frontend/server.mjs では SSR 失敗時に503を返す経路がある。

API の遅延と SSR の503が実際につながるか確認すること。別の障害が原因なら、その結果を報告すること。

2. 修正方針

最優先は、公開判定の意味を変えずに SQL 実行コストを削減すること。

以下を検討し、実際の実行計画と既存仕様に基づいて適切な修正を選択する。

  1. 全履歴に対して繰り返される集約を削減する。
  2. 履歴の除票境界を効率よく判定できる SQL に変更する。
  3. JSON_TABLE の評価対象や実行回数を削減する。
  4. 必要な index を調査し、既存 index を最大限利用する。
  5. count の負荷を削減する。ただし、公開可能な履歴の正確な件数という API 契約は維持する。
  6. ページネーションにより取得する履歴について、取得対象を早期に絞れる構造へ改善する。
  7. 一覧取得後のシリアライズでも不要な DB アクセスが発生していないか確認する。

SQL を複雑にするだけの抽象化や、裏付けのない最適化は避けること。

3. 公開制御の維持

性能改善を理由に、非 admin へ非公開履歴を開示してはならない。

特に次を維持する。

  • 除票された履歴の非公開。
  • 除票されたタグ・外部タグを参照する履歴の非公開。
  • 親投稿等の非公開参照に関する規則。
  • 復帰後の履歴可視性。
  • 非公開の直前バージョンを差分から推測できないこと。
  • admin と非 admin の権限差。
  • count・ページネーション・検索結果の整合性。

backend/spec/requests/post_history_privacy_spec.rb の既存仕様を必ず確認する。

公開条件を単純に削除したり、admin と同じ SQL を一般利用者へ適用したりする修正は禁止する。

4. Frontend の不整合

frontend/src/lib/prefetchers.ts の prefetchPostChanges() は、URL の id を fetchPostChanges() へ id プロパティで渡している。

一方、fetchPostChanges() の引数は post プロパティである。

このため、投稿 ID で絞り込まれない prefetch が発生する可能性がある。

  • URL の id と API 引数 post の対応を修正する。
  • React Query の query key と実際の取得条件を一致させる。
  • 個別投稿履歴の prefetch が全件履歴取得にならないようにする。
  • 回帰テストを追加する。

5. テスト

次の回帰テストを追加・調整する。

  • admin・member・guest の履歴可視性。
  • 除票、復帰、タグ参照、外部タグ参照、親投稿参照。
  • 非公開の直前バージョンを含む差分。
  • ページネーションを跨いだ件数と表示順序。
  • 空の履歴と大量の履歴を想定した取得。
  • 投稿 ID 指定時の prefetch。

必要に応じて、SQL クエリ数や実行計画を確認できる性能回帰テストを追加してよい。ただし、実行時間だけに依存する不安定なテストは避ける。

テストの追加・修正は行ってよいが、テストコマンドの実行は別途許可を得ること。

6. 禁止事項

  • API timeout を延長するだけで修正完了としない。
  • 公開判定を省略・緩和しない。
  • 正確な件数を無断で概算値に変更しない。
  • 公開情報と非公開情報を混在させるキャッシュを追加しない。
  • 仕様の異なる V2 へ変更を加えない。
  • 関係のないリファクタリングを行わない。
  • SYSTEM_SPEC.md を変更しない。
  • 既存のコーディングスタイルを無断で変更しない。
  • migration、DB 更新、テスト、lint、build を無断で実行しない。

schema や index の変更が必要と判断した場合は、具体的な理由と代替案を説明し、所有者の承認を得ること。承認前に migration ファイルを変更しない。

7. 完了条件

  • 非 admin で /posts/changes を正常に表示できる。
  • 非 admin の SQL 負荷が、修正前より明確に改善している。
  • admin の正常動作を維持している。
  • 履歴公開制御、件数、差分、ページネーションの仕様を維持している。
  • 個別投稿履歴の prefetch が正しい条件で動作する。
  • 既存の機能に対する回帰テストが用意されている。

実測可能な環境がない場合は、性能改善を確認済みと断定しないこと。

8. 最終報告

以下を報告する。

  1. 根本原因と根拠。
  2. 変更したファイルと各変更の目的。
  3. 修正前後の SQL または実行計画の比較。
  4. 実施した検証と未実施の検証。
  5. 残存する性能上・権限上のリスク。

本件は V1 の障害修正である。V2 への移行を理由に応急処置だけで済ませず、かつ V1 の大規模な再設計にも発展させないこと。

## 対象 - リポジトリ:`btrc-hub`(V1) - 対象画面:`/posts/changes`(locale prefix 付き URL を含む) - 症状:`admin` では表示できるが、`member`・`guest` では HTTP 503 が発生する。 - 原因の仮説:非 `admin` の履歴公開判定を伴う SQL が重く、SSR から Rails API へのアクセスがタイムアウトしている。 本番環境での原因は未確定。仮説を検証してから修正すること。 ## 調査対象ファイル - `backend/app/models/history_access.rb` - `backend/app/controllers/post_versions_controller.rb` - `backend/spec/requests/post_history_privacy_spec.rb` - `frontend/src/lib/api.ts` - `frontend/src/lib/prefetchers.ts` - `frontend/src/lib/prefetchers.test.ts` - `frontend/src/lib/posts.ts` - `frontend/src/pages/posts/PostHistoryPage.tsx` - `frontend/server.mjs` 必要に応じて関連モデル、migration、index 定義、テストも調査すること。 ## 1. 原因調査 ### 1.1 権限による SQL の相違 `HistoryAccess.sql()` は `admin` に対して `TRUE` を返すが、それ以外では複雑な履歴公開判定を生成する。 次を重点的に調査する。 - `event_type = 'discard'` に基づく履歴境界判定 - `GROUP BY` / `MAX(version_no)` を使った集約 - `NOT EXISTS` の相関条件 - `JSON_TABLE` を使ったタグ・外部タグ参照の検証 - 親投稿とタグ履歴の参照検証 - `snapshot_reference()` で行う追加の履歴照会 - 複合 index の有無と利用可能性 DB の実行計画を確認可能な環境では `EXPLAIN` 等でボトルネックを特定する。高負荷になり得る計測を本番 DB に無断で実行しないこと。 ### 1.2 全件 count `PostVersionsController#index` には次の処理がある。 ```ruby count = q.except(:select, :order, :limit, :offset).count ``` 非 `admin` では `HistoryAccess.visible()` が適用された状態で全件集計される。 この count が主なボトルネックになっていないか確認すること。 また、ページ取得用の `pluck` と、その後の `version_scope.merge(q)` による取得についても、不要な条件の再評価や過剰な JOIN が発生していないか確認する。 ### 1.3 SSR `frontend/src/lib/api.ts` では SSR 時の API timeout が10秒に設定されている。 `frontend/server.mjs` では SSR 失敗時に503を返す経路がある。 API の遅延と SSR の503が実際につながるか確認すること。別の障害が原因なら、その結果を報告すること。 ## 2. 修正方針 最優先は、**公開判定の意味を変えずに SQL 実行コストを削減すること**。 以下を検討し、実際の実行計画と既存仕様に基づいて適切な修正を選択する。 1. 全履歴に対して繰り返される集約を削減する。 2. 履歴の除票境界を効率よく判定できる SQL に変更する。 3. `JSON_TABLE` の評価対象や実行回数を削減する。 4. 必要な index を調査し、既存 index を最大限利用する。 5. `count` の負荷を削減する。ただし、公開可能な履歴の正確な件数という API 契約は維持する。 6. ページネーションにより取得する履歴について、取得対象を早期に絞れる構造へ改善する。 7. 一覧取得後のシリアライズでも不要な DB アクセスが発生していないか確認する。 SQL を複雑にするだけの抽象化や、裏付けのない最適化は避けること。 ## 3. 公開制御の維持 **性能改善を理由に、非 `admin` へ非公開履歴を開示してはならない。** 特に次を維持する。 - 除票された履歴の非公開。 - 除票されたタグ・外部タグを参照する履歴の非公開。 - 親投稿等の非公開参照に関する規則。 - 復帰後の履歴可視性。 - 非公開の直前バージョンを差分から推測できないこと。 - `admin` と非 `admin` の権限差。 - `count`・ページネーション・検索結果の整合性。 `backend/spec/requests/post_history_privacy_spec.rb` の既存仕様を必ず確認する。 公開条件を単純に削除したり、`admin` と同じ SQL を一般利用者へ適用したりする修正は禁止する。 ## 4. Frontend の不整合 `frontend/src/lib/prefetchers.ts` の `prefetchPostChanges()` は、URL の `id` を `fetchPostChanges()` へ `id` プロパティで渡している。 一方、`fetchPostChanges()` の引数は `post` プロパティである。 このため、投稿 ID で絞り込まれない prefetch が発生する可能性がある。 - URL の `id` と API 引数 `post` の対応を修正する。 - React Query の query key と実際の取得条件を一致させる。 - 個別投稿履歴の prefetch が全件履歴取得にならないようにする。 - 回帰テストを追加する。 ## 5. テスト 次の回帰テストを追加・調整する。 - `admin`・`member`・`guest` の履歴可視性。 - 除票、復帰、タグ参照、外部タグ参照、親投稿参照。 - 非公開の直前バージョンを含む差分。 - ページネーションを跨いだ件数と表示順序。 - 空の履歴と大量の履歴を想定した取得。 - 投稿 ID 指定時の prefetch。 必要に応じて、SQL クエリ数や実行計画を確認できる性能回帰テストを追加してよい。ただし、実行時間だけに依存する不安定なテストは避ける。 **テストの追加・修正は行ってよいが、テストコマンドの実行は別途許可を得ること。** ## 6. 禁止事項 - API timeout を延長するだけで修正完了としない。 - 公開判定を省略・緩和しない。 - 正確な件数を無断で概算値に変更しない。 - 公開情報と非公開情報を混在させるキャッシュを追加しない。 - 仕様の異なる V2 へ変更を加えない。 - 関係のないリファクタリングを行わない。 - `SYSTEM_SPEC.md` を変更しない。 - 既存のコーディングスタイルを無断で変更しない。 - migration、DB 更新、テスト、lint、build を無断で実行しない。 schema や index の変更が必要と判断した場合は、具体的な理由と代替案を説明し、所有者の承認を得ること。承認前に migration ファイルを変更しない。 ## 7. 完了条件 - 非 `admin` で `/posts/changes` を正常に表示できる。 - 非 `admin` の SQL 負荷が、修正前より明確に改善している。 - `admin` の正常動作を維持している。 - 履歴公開制御、件数、差分、ページネーションの仕様を維持している。 - 個別投稿履歴の prefetch が正しい条件で動作する。 - 既存の機能に対する回帰テストが用意されている。 実測可能な環境がない場合は、性能改善を確認済みと断定しないこと。 ## 8. 最終報告 以下を報告する。 1. 根本原因と根拠。 2. 変更したファイルと各変更の目的。 3. 修正前後の SQL または実行計画の比較。 4. 実施した検証と未実施の検証。 5. 残存する性能上・権限上のリスク。 本件は V1 の障害修正である。V2 への移行を理由に応急処置だけで済ませず、かつ V1 の大規模な再設計にも発展させないこと。
テツノニジカ がラベル ai:running を追加、 ai:ready を除去 2026-11-18 20:40:14 +09:00
テツノニジカ がラベル ai:blocked を追加、 ai:running を除去 2026-11-18 20:58:15 +09:00
共同作業者

Nightly Codex stopped: Agent-owned path not readable by work group: /var/lib/gitea-codex-v4/runs/impl/issue-485-5cicl5k1/repo/backend/config/database.yml
Workspace retained: issue-485-5cicl5k1

Codex 利用枠(取得: 2026-11-18 20:58 JST)
5 h の残量: 取得不可
5 h の恢復時刻: 取得不可
1 週間の残量: 取得不可
1 週間の恢復時刻: 取得不可

Nightly Codex stopped: Agent-owned path not readable by work group: /var/lib/gitea-codex-v4/runs/impl/issue-485-5cicl5k1/repo/backend/config/database.yml Workspace retained: issue-485-5cicl5k1 Codex 利用枠(取得: 2026-11-18 20:58 JST) 5 h の残量: 取得不可 5 h の恢復時刻: 取得不可 1 週間の残量: 取得不可 1 週間の恢復時刻: 取得不可
共同作業者

Codex 最終回答(原因調査用):

修正を実装しました。本番の根本原因と性能改善量は未確定です。コード上では「API の10秒 timeout → SSR 例外 → 503」の経路と、非 admin SQL の重複処理を確認しました。

変更したファイルと目的:

  • history_access.rb:除票境界を同じ複合キー・版番号による NOT EXISTS に変更。JSON 参照の除票判定からも集約を削除。
  • post_versions_controller.rb:公開判定・ページ選択後に差分を結合。正確な件数と旧版の公開判定は維持。
  • prefetchers.ts:URL の id を取得条件・query key ともに post へ対応。
  • 履歴の回帰テスト、prefetch の回帰テスト:権限別の公開範囲、復帰・参照・差分、空履歴、複数ページ、取得条件とキャッシュの一致を追加。

SQL 構造の比較です。実行計画・実測値ではありません。

対象 修正前 修正後
除票境界 全体の GROUP BY / MAX(version_no) 同一リソースの後続除票を照会
JSON 参照 除票 ID を集約して JOIN 履歴へ直接 JOIN
ページ取得 ID 取得後、公開条件を再評価して本文取得 ページ選択と差分取得を一つの SQL に統合

git diff --check は通過しました。指示どおりテスト・lint・build・DB 操作は実行していません。

EXPLAIN、正常表示の確認、性能計測は未実施です。全件 count、参照判定、並べ替えの負荷は残るため、503 の解消と公開制御の実動作は、管理者側の検証待ちです。

Codex 最終回答(原因調査用): 修正を実装しました。本番の根本原因と性能改善量は未確定です。コード上では「API の10秒 timeout → SSR 例外 → 503」の経路と、非 admin SQL の重複処理を確認しました。 変更したファイルと目的: - [history_access.rb](/var/lib/gitea-codex-v4/runs/impl/issue-485-5cicl5k1/repo/backend/app/models/history_access.rb):除票境界を同じ複合キー・版番号による `NOT EXISTS` に変更。JSON 参照の除票判定からも集約を削除。 - [post_versions_controller.rb](/var/lib/gitea-codex-v4/runs/impl/issue-485-5cicl5k1/repo/backend/app/controllers/post_versions_controller.rb):公開判定・ページ選択後に差分を結合。正確な件数と旧版の公開判定は維持。 - [prefetchers.ts](/var/lib/gitea-codex-v4/runs/impl/issue-485-5cicl5k1/repo/frontend/src/lib/prefetchers.ts):URL の `id` を取得条件・query key ともに `post` へ対応。 - [履歴の回帰テスト](/var/lib/gitea-codex-v4/runs/impl/issue-485-5cicl5k1/repo/backend/spec/requests/post_history_privacy_spec.rb)、[prefetch の回帰テスト](/var/lib/gitea-codex-v4/runs/impl/issue-485-5cicl5k1/repo/frontend/src/lib/prefetchers.test.ts):権限別の公開範囲、復帰・参照・差分、空履歴、複数ページ、取得条件とキャッシュの一致を追加。 SQL 構造の比較です。実行計画・実測値ではありません。 | 対象 | 修正前 | 修正後 | |---|---|---| | 除票境界 | 全体の `GROUP BY / MAX(version_no)` | 同一リソースの後続除票を照会 | | JSON 参照 | 除票 ID を集約して JOIN | 履歴へ直接 JOIN | | ページ取得 | ID 取得後、公開条件を再評価して本文取得 | ページ選択と差分取得を一つの SQL に統合 | `git diff --check` は通過しました。指示どおりテスト・lint・build・DB 操作は実行していません。 EXPLAIN、正常表示の確認、性能計測は未実施です。全件 count、参照判定、並べ替えの負荷は残るため、503 の解消と公開制御の実動作は、管理者側の検証待ちです。
共同作業者

未検証の変更を Gitea に WIP 保存しました。
保存先: ai/recovery/issue-485-5cicl5k1 / commit a55408dc32
既存 PR のブランチは変更していません。マージせずレビューしてください。

未検証の変更を Gitea に WIP 保存しました。 保存先: ai/recovery/issue-485-5cicl5k1 / commit a55408dc32da 既存 PR のブランチは変更していません。マージせずレビューしてください。
みてるぞ がラベル
status
in-progress
を追加、
status
ready
を除去 2026-11-18 21:47:20 +09:00
サインインしてこの会話に参加。
2 人の参加者
通知
期日
期日は設定されていません。
依存関係

依存関係は設定されていません。

リファレンス: miteruzo/btrc-hub#485