移行したあとで、記事の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 On | mod_rewrite を有効にする |
RewriteCond %{REQUEST_URI} !^/posts/[0-9]+/?$ | /posts/数字/ ではないときだけ、次のルールを使う(ページ送りを除外) |
RewriteRule ^posts/([^/]+)/?$ /$1/ [R=301,L] | /posts/<スラッグ>/ を /<スラッグ>/ へ 301 で飛ばす |
フラグの意味は、こうです。
R=301:恒久的なリダイレクト。もう戻す予定はないので 302(一時的)ではなく 301L:このルールで処理を終わる
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)