ルート / のリダイレクト方式は静的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…」のような中間ページを表示しない |
| R2 | LLM/クローラーが内容を取得できる | JS非実行のクローラーでも /ja/ の内容に到達できる |
| R3 | JS不要 | クライアントサイドJSに依存しない |
| R4 | ボットにも安全 | 検索エンジンのクロールを阻害しない |
| R5 | 無料枠を脅かさない | Cloudflare Pages の Functions 無料枠を消費しない、または最小限 |
| R6 | enも促進 | /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 + Cookie | index.astro のJSがCookieを読み location.replace |
| E. 静的301 | _redirects に / /ja/ 301 を1行配置 |
要求 × 案 の充足マトリクス
✅ = 満たす、△ = 部分的に満たす/条件付き、❌ = 満たさない(諦める)
| 要求 | A. 現状維持 | B. 無効化のみ | C. Functions | D. JS+Cookie | E. 静的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/ 301src/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-langCookieに保存する(既存実装を維持) - enの促進は、各ページの
<a hreflang>とsitemapで行う - 将来R7(言語自動判定)が必要になった場合は、本決定をsupersedeする新しいADRを作成し、C案へ移行する