8.7 KiB
Issue #485: V1 投稿履歴の非 admin アクセス時 HTTP 503
PR #489 レビューの遅延ログへの対応
レビューで提示されたログでは、履歴本文の SELECT が31249.2ms、API 全体が 64588ms、ActiveRecord が64396msかかっている。従来の変更で障害が解消したとは 言えない。変更前の同条件の計測値がないため、悪化率も算出できない。 提示範囲には公開件数の count の所要時間がなく、その負荷は別途確認が必要。
今回の変更は HistoryAccess.snapshot_reference の外部タグ参照だけに限定する。
従来は投稿時点以前の外部タグ履歴を結合し、各候補の公開判定と、より大きい版番号の
有無を評価する SQL だった。変更後は同じタグ ID・投稿時点の条件で
MAX(candidate.version_no) を求め、既存の (tag_id, version_no) unique index に
対応する1版へ結合してから公開判定する。最新の版が非公開でも過去の公開版へ
遡らない。時刻順が版番号順と異なる場合や同時刻でも、従来どおり最大版番号を使う。
除票境界、参照先の公開判定、正確な count、直前版の認可は変更しない。
回帰テストには、同時刻・時刻と版番号の順序不一致・投稿より未来の版を組み合わせ、 anonymous・guest・member・admin の件数と履歴の確認を追加した。 担当エージェントはテスト・lint・build・DB 操作を実行していない。
管理側で post_history_privacy_spec.rb と history_access_spec.rb、共有認可を使う
Counts・各履歴の回帰を確認する。許可された非本番の同一データで、変更前後の
count と本文 SELECT の実行計画・所要時間を個別に比較する必要がある。
特に外部タグ参照が複合キーで1版へ絞られるか、過去の各版に対して公開判定を
繰り返さないかを確認し、SSR の10秒 timeout 内で応答できるかも計測する。
この変更での速度改善量と503解消は未確認であり、他の相関条件や全件 count の
負荷も残る。実行計画未取得のため、本番遅延の根本原因の確定ではない。
対象は V1 の /posts/changes(locale prefix 付き URL を含む)。
Issue では admin は表示でき、member・guest では HTTP 503 が発生すると報告されている。
本番の根本原因、503 の解消、SQL の性能改善量は未確定。
既存の feature/485(引継ぎ時点 6329958)の成果を以下に整理する。
文書の整理に加え、管理側ゲートで判明した MDX テスト補助コードの設定読取を修正する。
コードから確認できる経路と未確定事項
- HistoryAccess は admin に
TRUEを返す。 非 admin には除票境界、タグ・外部タグ・親投稿の参照公開判定を適用する。 - PostVersionsController は 公開条件と検索条件を適用して全件 count を取得する。 count が主なボトルネックかどうかは、実行計画・計測がなく未判定。
- api.ts の SSR API timeout は10秒。 entry-server.tsx はデータ準備中の API timeout 等を再送出し、 server.mjs は SSR 例外に対して原則503を返す。 API 遅延が503につながる経路はあるが、本番でこの経路が発生した証拠は未取得。
- シリアライズはユーザー名・タグ名・外部タグ名をページ内の ID で一括取得する構造。 本番の照会回数・所要時間の計測結果はない。
引継ぎ済みの修正
backend/app/models/history_access.rb:除票境界の集約を、同じリソースキーとversion_noによる後続除票のNOT EXISTS判定に変更。 JSON 参照の除票照会も履歴テーブルへの直接 JOIN に変更。backend/app/controllers/post_versions_controller.rb:タグ条件なしでは、公開条件による ページ選択後に直前版を結合。タグ条件ありでは、絞込に使う認可済み直前版を差分にも再利用。 正確な count とcreated_at DESC, id DESCの順序は維持する構造。- prefetchers.ts:URL の
idをfetchPostChangesのpost引数とpostsKeys.changesのpostに対応させる。 PostHistoryPage.tsx の取得条件と一致させる修正。 - vite.config.ts と
vitest.config.ts:既存成果には build 時の
jsxDev: falseと、 関数形式の Vite 設定を Vitest から読み込む変更も含まれる。
SQL 構造の比較
比較元は引継ぎ済み修正の直前 dda3d87。実行計画・実測値の比較ではない。
| 対象 | 修正前 | 引継ぎ済みの構造 |
|---|---|---|
| 除票境界 | リソースキーごとの GROUP BY / MAX(version_no) |
同一キーで対象版以降の除票を NOT EXISTS で照会 |
| JSON 参照の除票判定 | 除票キーを集約した派生表へ JOIN | 履歴テーブルへ直接 JOIN し、除票を1件検出すれば終了 |
| ページ取得 | ID の pluck 後に公開条件付きで本文を再取得 |
ページ選択と差分取得を一つの SQL にまとめ、認可済み直前版を再利用 |
| count | 公開・検索条件適用後の正確な全件集計 | 同じ契約を維持。集計自体は残る |
schema.rb には post_versions(post_id, version_no)、
tag_versions(tag_id, version_no)、nico_tag_versions(tag_id, version_no) の
複合 unique index がある。新しい照会での利用状況は EXPLAIN による確認が必要。
migration・schema・index の追加変更は行っていない。
引継ぎ済みの回帰テスト
- post_history_privacy_spec.rb: anonymous・guest・member・admin の可視性、除票と恢復、タグ・外部タグ・親投稿参照、 非公開直前版の旧値と差分、認可済み直前版によるタグ追加・削除の絞込、空履歴、 複数ページの正確な件数・同時刻の表示順序、履歴 SELECT と直前版 JOIN の回数を確認する内容。 タグ factory のロカール補完で第1版が重複しないためのデータ修正も含む。
- prefetchers.test.ts:locale prefix の有無と
ain-Kana、投稿 ID とタグ・外部タグ条件、query key と取得条件の一致、 同じ QueryClient における投稿別履歴と全件履歴のキャッシュ分離を確認する内容。 - server.ssr.test.mjs:ロカールと権限ごとの HTTP 200、 履歴テーブルの SSR、API の投稿・ページ条件と取得回数を確認する内容。 API スタブを用いるため、Rails SQL の性能や公開判定の実証にはならない。
検証状況と残る確認
管理側ゲートは frontend の578件を実行し、571件合格・7件不合格だった。
不合格はすべて mdx-components.test.tsx で、関数形式の Vite 設定から直接
plugins を読んだために発生した。ログは validation-step-57_7ge7z.log。
compileMdx.ts を、Vitest の設定と同様に
viteConfig に command: 'serve', mode: 'test' を渡してからプラグインを読む形に修正。
GFM の表、見出し・段落・一覧、長いセル、raw・url の変換除外、内部リンクの
既存回帰テストは維持する。
同じ検証では frontend/help/.git の権限修復エラーも別途報告されている。
担当エージェントはテスト・lint・build・DB 操作を実行していない。 修正後の固定スイートによる再検証と合否判定は管理側に委ねる。 この文書は修正後の合格記録ではない。
本番サービス・DB・外部認証情報にはアクセスしていない。
EXPLAIN、実データ規模での前後比較、実画面での503解消確認は行っていない。
全件 count、残る参照集約、JSON_TABLE・snapshot_reference、ソートの負荷は残る。
共有の HistoryAccess を使う他の履歴経路についても回帰確認が必要。
除票以前の版と参照履歴の秘匿、恢復後も解除しない規則、非公開直前版の差分遮断は
性能を理由に緩和せず、権限別の回帰テストと実行計画の両方で確認する。