decisiondecided

ルート / のリダイレクト方式は静的301を採用する

blog.parlourite.com の / → /ja/ リダイレクトを、Astroのmeta refreshでもJSでもFunctionsでもなく、Cloudflare Pages の _redirects による静的301で実装する。中間リダイレクトページを排除し、LLM/クローラーにも確実に内容を届ける。

Context

blog.parlourite.com のルート / にアクセスすると「Redirecting from / to /ja/」という中間ページが表示される。これは Astro i18n の redirectToDefaultLocale: true が生成する meta refresh ページであり、作者はこの表示に不満を持っていた。

議論の過程で、解決すべき目的が段階的に明確化された。当初は「中間ページの表示をなくすこと」だったが、検討を進める中で「LLM/クローラーに内容を届けること(SEO的有利さ)」「JSに依存しないこと」「ボットにも安全であること」「Cloudflareの無料枠を脅かさないこと」「enも促進すること」「言語選択を永続化すること」「管理コストを増やさず今後変更しなくて済むこと」が、それぞれ独立した要求として浮上した。これは設計要件を洗い出す正常な比較プロセスであり、各要求をどの案がどこまで満たすかを整理する必要がある。

本ADRは、これらの要求を満たす候補案を比較し、ルート/のリダイレクト方式を決定するものである。

要求(評価軸)

議論で挙がった要求を、評価軸として明示する。

#要求内容
R1中間リダイレクトページを出さない「Redirecting…」のような中間ページを表示しない
R2LLM/クローラーが内容を取得できるJS非実行のクローラーでも /ja/ の内容に到達できる
R3JS不要クライアントサイドJSに依存しない
R4ボットにも安全検索エンジンのクロールを阻害しない
R5無料枠を脅かさないCloudflare Pages の Functions 無料枠を消費しない、または最小限
R6enも促進/en/ の存在をGoogleに伝え、クロール・インデックスを促す
R7言語自動判定初回訪問時にブラウザ言語へ自動誘導する(UX)
R8言語選択の永続化ユーザーが選んだ言語を以降の訪問でも維持する
R9管理コスト低・枯れた技術追加実装が少なく、今後変更しなくて済む
R10変更が最小設定変更やファイル追加が最小限である

候補案

案内容
A. 現状維持(meta refresh)redirectToDefaultLocale: true のまま。Astroが中間ページを生成
B. リダイレクト無効化のみredirectToDefaultLocale: false のみ。/ の表示内容は別途設計
C. Functions + Accept-Languageエッジ関数で言語判定し302。ボットにはhreflang付きHTMLを返す
D. JS + Cookieindex.astro のJSがCookieを読み location.replace
E. 静的301_redirects に / /ja/ 301 を1行配置

要求 × 案 の充足マトリクス

✅ = 満たす、△ = 部分的に満たす/条件付き、❌ = 満たさない(諦める)

要求A. 現状維持B. 無効化のみC. FunctionsD. JS+CookieE. 静的301
R1 中間ページなし❌✅✅△(一瞬ちらつく)✅
R2 LLM/クローラーが内容取得△(meta refreshは追随されうるが不安定)❌(/ が404/空)✅❌(JS非実行クローラーは不可)✅
R3 JS不要✅✅✅❌✅
R4 ボットに安全△△(/ が404)✅(ボット分岐が必要)❌(ボットはJS不可)✅
R5 無料枠を脅かさない✅✅△(_routes.jsonで限定すれば可)✅✅
R6 enも促進△(hreflang次第)△✅(hreflang付きHTML)△(リンク次第)△(スイッチャー/sitemapのhreflang次第)
R7 言語自動判定❌❌✅❌(Cookieのみ、初回はja)❌(初回英語話者はja)
R8 言語選択の永続化❌❌✅(Cookie)✅(Cookie)✅(スイッチャーのCookie)
R9 管理コスト低・枯れた✅(変更なし)✅❌(Functions保守)△(JS保守)✅
R10 変更が最小✅(0)✅(1行)❌(複数ファイル)△(1ファイル+修正)✅(2箇所)

マトリクスから読み取れること

  • R1・R2・R3・R4 を同時に満たすのは、C(Functions)とE(静的301) のみ。DはJS依存のためR2・R4を満たさない。AはR1を満たさず、BはR2を満たさない。
  • R5・R9・R10 を同時に満たすのは、E(静的301) のみ。CはFunctions保守と複数ファイル追加のコストを伴う。
  • R7(言語自動判定) を満たすのは Cのみ。Eはこれを諦める代わりに、R5・R9・R10で優位に立つ。
  • R8(永続化) はC・D・Eで満たせる。Eでも言語スイッチャーのCookieで実現可能。
  • R6(en促進) は、Eでもスイッチャーとsitemapのhreflangで部分的に満たせる。Cはボット向けHTMLでより明示的に満たすが、その分の実装コストがかかる。

つまり、R7(自動判定)を必須とするか、諦めてよいかが分岐点である。R7を諦めれば、EがR1〜R6・R8〜R10をバランスよく満たす。R7を必須とすればCしか残らないが、R9・R10のコストを払うことになる。

Decision

E. 静的301 を採用する。

public/_redirects に以下を配置し、Cloudflare Pages のサーバーサイド301で / を /ja/ へ転送する。Astro側は redirectToDefaultLocale: false にして meta refresh ページの生成を止める。

/ /ja/ 301

src/pages/index.astro は不要(削除可)。Accept-Languageによる自動言語判定(R7)は行わない。言語切替は各ページの言語スイッチャー(Cookie pref-lang 永続化)で行う。enの促進(R6)は、言語スイッチャーの<a hreflang>とsitemapで行う。

Consequences

メリット

  • R1・R2・R3・R4を満たす。中間ページが消え、LLM/クローラーは301を追随して/ja/の内容を取得できる
  • R5・R9・R10を満たす。Functions不要で無料枠を消費せず、変更は_redirects1行とastro.config.mjs1行のみ。枯れたHTTP 301のみに依存
  • R8は言語スイッチャーのCookieで満たせる
  • SEO的にクリーン(301でリンク評価を正しく伝達)

デメリット(諦める要求)

  • R7(言語自動判定)を諦める。初回訪問の英語話者も/ja/に着地する。言語スイッチャーを目立つ位置に置くことで緩和する
  • R6(en促進)は、Cのようにボット向けhreflang付きHTMLを返すほど明示的ではない。スイッチャーとsitemapのhreflangで対応する

Alternatives Considered

  • C. Functions + Accept-Language: R7を満たす唯一の案だが、R9・R10のコスト(Functions保守、ボット判定、キャッシュ制御、_routes.json)を伴う。R7を必須とするなら次点候補。将来R7が必要になった場合は、本決定をsupersedeする新しいADRでCへ移行する
  • D. JS + Cookie: R1でちらつきが残り、R2・R4を満たさない。不採用
  • A. 現状維持 / B. 無効化のみ: R1またはR2を満たさない。不採用

運用

  • 言語切替は各ページの言語スイッチャーで行い、pref-lang Cookieに保存する(既存実装を維持)
  • enの促進は、各ページの<a hreflang>とsitemapで行う
  • 将来R7(言語自動判定)が必要になった場合は、本決定をsupersedeする新しいADRを作成し、C案へ移行する