Skip to content
sakura86.com
戻る

WordPressからAstroへ移行した話(11).htaccessで旧URLを301リダイレクトする

移行したあとで、記事のURLを変えました。

AstroPaper は、初期状態だと記事の URL が /posts/<スラッグ>/ になります。
WordPress 時代は /<スラッグ>/ だったので、これを元に戻した形です。

前回はお問い合わせフォームでした。
今回は、URL を戻したあとに残った旧 URL を、.htaccess で新しい URL へ 301 リダイレクトした話です。

何があったか

経緯は、こんな感じです。

  • WordPress 時代の記事 URL は /<スラッグ>/
  • AstroPaper の初期状態は /posts/<スラッグ>/。移行直後はこれで公開していた
  • 2026年6月8日に、記事 URL を /<スラッグ>/ へ変更した(WordPress と同じ形に統一)
    • getPath.ts の basePath を空にして、/posts を付けないようにした
    • 記事のページを pages/posts/[...slug]/ から pages/[...slug]/ へ移動した
    • 記事の中の他記事へのリンクを、約220ファイルぶん一括で置き換えた

ですが、本番のサーバーには旧 URL(/posts/<スラッグ>/)のページが残っていました。
検索結果や、ほかのサイトのリンクにも、旧 URL が残っているかもしれません。
そこで、旧 URL に来たら新 URL へ飛ばすことにしました。

ちなみに、記事一覧のページ送りは今も /posts/2/ /posts/3/ のままです。
こちらは本当に存在する URL なので、リダイレクトの対象から外す必要があります。

.htaccess の置き場所

.htaccess も、public/ に置けば dist/ にそのままコピーされます。
あとは FTP のデプロイで、サーバーのルートに送られます。

public/
  .htaccess   ← dist/.htaccess → サーバーのルートへ

最初に書いたルール

最初は、これだけでした。

RewriteEngine On

# /posts/<slug>/ → /<slug>/ へ 301 リダイレクト(個別記事の旧 URL 対策)
# ページネーション /posts/2/ /posts/3/ ... は除外
RewriteCond %{REQUEST_URI} !^/posts/[0-9]+/?$
RewriteRule ^posts/([^/]+)/?$ /$1/ [R=301,L]
行意味
RewriteEngine Onmod_rewrite を有効にする
RewriteCond %{REQUEST_URI} !^/posts/[0-9]+/?$/posts/数字/ ではないときだけ、次のルールを使う(ページ送りを除外)
RewriteRule ^posts/([^/]+)/?$ /$1/ [R=301,L]/posts/<スラッグ>/ を /<スラッグ>/ へ 301 で飛ばす

フラグの意味は、こうです。

  • R=301:恒久的なリダイレクト。もう戻す予定はないので 302(一時的)ではなく 301
  • L:このルールで処理を終わる

RewriteCond の先頭の ! は「一致しない場合」の意味です。
ページ送りの /posts/2/ が一致するので、その場合はリダイレクトしません。

あとから足した条件

2026年7月5日に、ルールを直しています。
Search Console に「リダイレクトエラー」が出たからです。

最初のルールだと、存在しないスラッグでも /posts/なんとか/ に来たら /なんとか/ へ 301 で飛ばします。
飛んだ先が 404 なので、「301 → 404」になってしまいます。これが、エラーとして検出されました。

そこで、飛ばす先のディレクトリが実際にあるときだけ 301 にしました。

RewriteCond %{REQUEST_URI} !^/posts/[0-9]+/?$
RewriteCond %{DOCUMENT_ROOT}/$1 -d
RewriteRule ^posts/([^/]+)/?$ /$1/ [R=301,L]

2行目の %{DOCUMENT_ROOT}/$1 -d が追加した条件です。
$1 は、すぐ下の RewriteRule で括弧に入れた部分(スラッグ)を指します。-d は「そのディレクトリが存在するか」の判定です。

これで、存在しないスラッグは普通の 404 になります。

www と http もまとめて統一

同じ日に、ホストの統一も足しました。

# 正規ホストへ統一(http / www 付きアクセスを https の非www へ301)
RewriteCond %{HTTPS} off [OR]
RewriteCond %{HTTP_HOST} ^www\. [NC]
RewriteRule ^ https://sakura86.com%{REQUEST_URI} [R=301,L]

http でも、www 付きでも、全部 https://sakura86.com/ へ 301 で飛ばします。
コアサーバーでは http から https への転送が自動で働く、と以前の記事には書きました。
ですが Search Console に「代替ページ」が出たので、ルールとして明示することにしました。

スラッグを変えたときの個別リダイレクト

連番だったスラッグの記事3本は、内容に沿った名前へ変えました。
このときも、旧 URL から 301 を設定しています。

RewriteRule ^post-7973/?$ /sql-escape-single-quote/ [R=301,L]
RewriteRule ^post-8303/?$ /vscode-beginner-basic-settings/ [R=301,L]
RewriteRule ^post-8307/?$ /vscode-useful-extensions/ [R=301,L]

全文

今の public/.htaccess は、こうなっています。

RewriteEngine On

# 正規ホストへ統一(http / www 付きアクセスを https の非www へ301)
RewriteCond %{HTTPS} off [OR]
RewriteCond %{HTTP_HOST} ^www\. [NC]
RewriteRule ^ https://sakura86.com%{REQUEST_URI} [R=301,L]

# 記事スラッグ変更に伴う個別リダイレクト
RewriteRule ^post-7973/?$ /sql-escape-single-quote/ [R=301,L]
RewriteRule ^post-8303/?$ /vscode-beginner-basic-settings/ [R=301,L]
RewriteRule ^post-8307/?$ /vscode-useful-extensions/ [R=301,L]

# /posts/<slug>/ → /<slug>/ へ 301 リダイレクト(個別記事の旧 URL 対策)
# ページネーション /posts/2/ /posts/3/ ... は除外
# リダイレクト先が実在するディレクトリの場合のみ301し、存在しなければ通常の404に落とす
RewriteCond %{REQUEST_URI} !^/posts/[0-9]+/?$
RewriteCond %{DOCUMENT_ROOT}/$1 -d
RewriteRule ^posts/([^/]+)/?$ /$1/ [R=301,L]

動作の確認

ブラウザだと 301 がキャッシュされて、確認しにくいことがあります。
なので curl -I でヘッダーだけ見るのが楽です。2026年11月18日に、本番で確かめました。

# 実在する記事の旧URL → 301
curl -sI https://sakura86.com/posts/wp-to-astro-matome/
# HTTP/1.1 301 Moved Permanently
# Location: https://sakura86.com/wp-to-astro-matome/

# 存在しないスラッグ → 404
curl -sI https://sakura86.com/posts/this-slug-does-not-exist-xyz/
# HTTP/1.1 404 Not Found

# www 付き・http → 1回で https の非www へ 301
curl -sI http://www.sakura86.com/wp-to-astro-matome/
# HTTP/1.1 301 Moved Permanently
# Location: https://sakura86.com/wp-to-astro-matome/

# ページ送りは対象外 → 200
curl -sI https://sakura86.com/posts/2/
# HTTP/1.1 200 OK

気になった点

  • .htaccess は書き間違えると、サイト全体が 500 エラーになることがある。アップしたらすぐ確認したほうがいい
  • -d の判定は、サーバー上のファイルの有無に頼っている。ディレクトリ構成が変われば結果も変わる
  • 301 は、ブラウザや検索エンジンに長く覚えられる。やり直しがききにくいので、最初から 301 にしていいか考えてから書く

おわりに

URL を変えるのは一瞬でも、変えたあとに旧 URL の面倒を見る作業が残ります。
サイトの URL は、最初に決めておくのが一番ですね。

次回は、Search Console に出たエラーへの対処です。
WordPressからAstroへ移行した話(12)Search Consoleのエラー対処(noindex・サイトマップ・robots.txt)



シリーズ目次
WordPressからAstroへ移行した話 まとめ