Astroでリダイレクト設定がうまくいかない時の対処法【静的サイトSEO】#

なぜリダイレクトが SEO に重要なのか#

• 重複コンテンツ回避: 誤った URL と正しい URL が併存すると評価が分散!!
• 被リンクの継承: 301 / 308 リダイレクトなら被リンクの評価を新 URL へ移行可!!
• クロール効率の最適化: 不要な 404 を減らし、クロールバジェットを節約!!

TIP

Google は「恒久的（301 / 308）」「一時的（302）」を見分けて評価を移譲します。目的に合わせてステータスコードを選んでください！

前提環境#

• Astro v4（SSG モード）
• Cloudflare Pages でホスティング（Vercel でも同様に動作を確認）

方法①: astro.config.* でリダイレクトを定義する#

Astro の設定ファイルに redirects を追加する方法です。公式推奨 で管理も楽(大事)なため、少量のリダイレクトならこれで十分!!

export default defineConfig({
  redirects: {
    // ① 同一サイト内のパス移動（デフォルト 301）
    "/posts/old-slug": "/posts/new-slug",

    // ② 動的ルートも OK（パラメータ名は合わせる）
    "/blog/[...slug]": "/articles/[...slug]",

    // ③ ステータスコードを明示したいとき
    "/note": {              // 308＝恒久的 POST 可
      status: 308,
      destination: "/posts/note"
    },

    // ④ 外部 URL へ
    "/docs": "https://example.com/docs"
  }
});

• メリット: Astro だけで完結。SSG ビルド時に <meta http-equiv="refresh"> つき HTML が自動生成されます。
• デメリット: 大量のルールを記述すると設定ファイルが肥大化。

方法②: vercel.json を使う（Cloudflare Pages でも利用可）#

より細かい条件分岐やホスト名ベースの振り分けが必要なら vercel.json が便利です。

{
  "redirects": [
    {
      "source":  "/posts/old-slug",
      "destination": "/posts/new-slug",
      "permanent": true         // 308
    },
    {
      "source":      "/blog/:year/:month/:slug",
      "destination": "/posts/:slug",
      "statusCode":  301
    },
    {
      "source":      "/docs/:path*",
      "destination": "https://example.com/docs/:path*",
      "permanent":   true
    },
    {
      "source": "/:path*",
      "has": [
        { "type": "host", "value": "old.example.com" }
      ],
      "destination": "/legacy/:path*",
      "statusCode": 302
    }
  ]
}

• メリット
  • ワイルドカードやホスト条件など高機能。
  • 設定ファイルを分離できるので保守しやすい。
• デメリット
  • trailingSlash 設定に依存し、末尾スラッシュ強制削除の挙動に注意が必要。

WARNING

vercel.json で定義したリダイレクトは、デフォルトで末尾スラッシュを削除します。trailingSlash: "always" を指定している場合は整合性を要確認！

どちらを選ぶべき？#

私のサイトでは末尾スラッシュを必ず付与するため、方法①を採用しました。

まとめ#

• 正しいステータスコード を選び、評価をロスなく移譲しよう。
• Astro 標準の redirects がもっとも手軽。
• 高度な条件分岐や大量設定は vercel.json が便利。ただし trailingSlash との相性に注意。

AstroでのtrailingSlashの設定変更はこちらにあります!!

設定方法

docs.astro.build

参考リンク#

• Astro 公式ルーティングガイド
• Vercel リダイレクトガイド