タグ広場 V1 /posts/changes の非 admin アクセス時 503 を修正
#485
オープン
みてるぞが2026-11-18 20:38:11 +09:00 に作成
·
3件のコメント
ブランチ/タグ指定なし
main
ai/recovery/issue-414-4ki4y15_
feature/455
ai/recovery/pr-475-xh7l3rby
ai/recovery/pr-475-r9hul6ya
ai/recovery/pr-475-6muq2mhf
ai/recovery/issue-479-n7k8h8jk
ai/recovery/issue-414-euwzily9
feature/414
ai/recovery/issue-205-idew24v8
ai/recovery/issue-485-5cicl5k1
feature/485
feature/484
feature/483
feature/97
ai/recovery/issue-279-19j8bk0h
feature/242
feature/479
feature/445
ai/recovery/issue-479-7_zeuuw9
ai/recovery/issue-242-hhdxc839
feature/447
feature/404
feature/401
feature/454
feature/152
feature/149
feature/150
feature/170
feature/273
feature/446
feature/440
feature/320
feature/439
feature/437
feature/272
feature/436
feature/443
feature/450
feature/438
feature/448
feature/283
feature/451
feature/435
feature/444
feature/442
feature/434
feature/428
feature/431
feature/424
feature/425
feature/426
feature/422
feature/055
feature/419
feature/416
feature/411
feature/406
feature/354
feature/399
feature/409
feature/405
feature/398
feature/386
feature/268
feature/034
feature/385
feature/351
feature/076
feature/389
feature/360
feature/332
feature/352
feature/383
feature/306
feature/378
feature/376
feature/371
feature/370
feature/361
feature/041
feature/358
feature/302
feature/090
feature/155
feature/346
feature/171
feature/047
feature/327
feature/063
feature/046
feature/314
feature/329
feature/317
feature/323
feature/200
feature/321
feature/318
feature/309
feature/294
feature/308
feature/312
feature/095
feature/264
feature/279
feature/206
見つかりません。
ラベル
ラベルをクリア
ai:blocked
ai:effort:high
ai:effort:low
ai:effort:xhigh
ai:investigate
ai:mode:branch
ai:mode:pr
ai:model:astra
ai:model:luna
ai:model:terra
ai:needs-input
ai:ready
ai:review
ai:running
area/backend
area/frontend
duplicate
invalid
wontfix
P
0
P
1
P
2
P
3
status
blocked
status
in-progress
status
ready
status
review
type
bug
type
enhancement
type
task
マイルストーン
項目なし
マイルストーンなし
担当者なし
通知
期日
期日は設定されていません。
依存関係
依存関係は設定されていません。
リファレンス: miteruzo/btrc-hub#485
新しいイシューから参照
ユーザーをブロックする
ユーザーをブロックすると、そのユーザーは、プルリクエストやイシューの作成、コメントの投稿など、リポジトリに対する操作ができなくなります。 ユーザーのブロックについて詳しくはこちらをご覧ください。
対象
btrc-hub(V1)/posts/changes(locale prefix 付き URL を含む)adminでは表示できるが、member・guestでは HTTP 503 が発生する。adminの履歴公開判定を伴う SQL が重く、SSR から Rails API へのアクセスがタイムアウトしている。本番環境での原因は未確定。仮説を検証してから修正すること。
調査対象ファイル
backend/app/models/history_access.rbbackend/app/controllers/post_versions_controller.rbbackend/spec/requests/post_history_privacy_spec.rbfrontend/src/lib/api.tsfrontend/src/lib/prefetchers.tsfrontend/src/lib/prefetchers.test.tsfrontend/src/lib/posts.tsfrontend/src/pages/posts/PostHistoryPage.tsxfrontend/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()で行う追加の履歴照会DB の実行計画を確認可能な環境では
EXPLAIN等でボトルネックを特定する。高負荷になり得る計測を本番 DB に無断で実行しないこと。1.2 全件 count
PostVersionsController#indexには次の処理がある。非
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 実行コストを削減すること。
以下を検討し、実際の実行計画と既存仕様に基づいて適切な修正を選択する。
JSON_TABLEの評価対象や実行回数を削減する。countの負荷を削減する。ただし、公開可能な履歴の正確な件数という API 契約は維持する。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 が発生する可能性がある。
idと API 引数postの対応を修正する。5. テスト
次の回帰テストを追加・調整する。
admin・member・guestの履歴可視性。必要に応じて、SQL クエリ数や実行計画を確認できる性能回帰テストを追加してよい。ただし、実行時間だけに依存する不安定なテストは避ける。
テストの追加・修正は行ってよいが、テストコマンドの実行は別途許可を得ること。
6. 禁止事項
SYSTEM_SPEC.mdを変更しない。schema や index の変更が必要と判断した場合は、具体的な理由と代替案を説明し、所有者の承認を得ること。承認前に migration ファイルを変更しない。
7. 完了条件
adminで/posts/changesを正常に表示できる。adminの SQL 負荷が、修正前より明確に改善している。adminの正常動作を維持している。実測可能な環境がない場合は、性能改善を確認済みと断定しないこと。
8. 最終報告
以下を報告する。
本件は V1 の障害修正である。V2 への移行を理由に応急処置だけで済ませず、かつ V1 の大規模な再設計にも発展させないこと。
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 の重複処理を確認しました。
変更したファイルと目的:
NOT EXISTSに変更。JSON 参照の除票判定からも集約を削除。idを取得条件・query key ともにpostへ対応。SQL 構造の比較です。実行計画・実測値ではありません。
GROUP BY / MAX(version_no)git diff --checkは通過しました。指示どおりテスト・lint・build・DB 操作は実行していません。EXPLAIN、正常表示の確認、性能計測は未実施です。全件 count、参照判定、並べ替えの負荷は残るため、503 の解消と公開制御の実動作は、管理者側の検証待ちです。
未検証の変更を Gitea に WIP 保存しました。
保存先: ai/recovery/issue-485-5cicl5k1 / commit
a55408dc32既存 PR のブランチは変更していません。マージせずレビューしてください。