EmDash をサブパスに置く前に:/field-notes 配下のアドレスを 1 つずつ叩いてみた

Astro で base を設定したあと、どのアドレスが一緒に移動し、どれが移動しないのか。公開前に手で確認しておきたい箇所。

サイトをドメインまるごとではなく example.com/field-notes/ の下に置きたい。よくある要件です。メインのサイトは別のシステムで、ブログはその下にぶら下げるだけ、という形です。

Astro で対応する設定は base の 1 行だけです。だから私たちは、このガイドは短くなるだろうと思っていました。

ところが、新しくブログテンプレートのサイトを作り、base: "/field-notes" を設定してビルドし、起動して、すべてのアドレスを curl で叩いてみると、1 行の設定以外にも思ったより多くのことがありました。以下は、実際に見たものです。

テスト環境:EmDash 1.4.0、Node アダプター、SQLite、公式ブログテンプレート。テンプレート付属の 8 本の記事は emdash seed で投入しました。

export default defineConfig({
  output: "server",
  base: "/field-notes",
  // ...
});

どのアドレスが base に従って移動したか?

まず良い知らせです。ページ自体は問題ありません。

アドレス結果
/field-notes/200
/field-notes/posts200
/field-notes/rss.xml200
/field-notes/robots.txt200

どのアドレスが動かなかったか?

管理画面と API はその場に残ります。

アドレス結果
/_emdash/api/health200
/_emdash/admin302。/_emdash/admin/setup にリダイレクト

つまり、/_emdash で始まるものはすべて /field-notes の中には移りません。前段のルーティング規則は、/field-notes/* と /_emdash/* の両方をこのアプリケーションに送る必要があります。前者だけを送ると、管理画面は開きません。

ほかに私たちが出くわした 2 つのアドレスも触れておきます。/field-notes/_emdash/api/health と /field-notes/sitemap.xml は、どちらも 500 を返します。もともとアクセスされるべきアドレスではありませんが、チェック用スクリプトが「プレフィックスを付けて再試行する」という作りだと、驚くことになります。

もう 1 つ意外だったのは、ルートの / と /posts も 200 を返すことです。同じ内容に入口が 2 つあるということです。検索エンジンに 2 つのコピーを見せたくなければ、前段のルーティングで /field-notes/* と /_emdash/* だけを通し、それ以外は拒否してください。

ページ内のリンクには、1 つもプレフィックスが付いていない

これが私たちにとっていちばん予想外だった点です。/field-notes/ のトップページを開いてソースを表示すると、リンクは次のようになっています。

  • 記事 7 本:/posts/a-weekend-with-a-side-project など
  • タグ 4 つ:/tag/opinion など
  • ナビゲーションバー:/、/pages/about、/posts
  • そのほか /rss.xml、/search

どれにも /field-notes は付いていません。クリックするとサブパスから外れ、ルートパスの下に落ちます。

リンクの出どころは 2 か所あり、直す場所が違います。

  1. テンプレートのコードに直接書かれているもの。 たとえば src/pages/posts/[slug].astro の href={`/tag/${t.slug}`} や、いくつものページにある href="/posts" です。これらは import.meta.env.BASE_URL で始まるように書き換える必要があります。
  2. データベースに保存されているもの。 ナビゲーションの 3 項目は、テンプレートに書かれているのではなく、メニューのデータとして _emdash_menu_items テーブルに保存されており、アドレスは /、/pages/about、/posts です。テンプレートだけを直しても、ナビゲーションバーはまったく変わりません。メニュー項目自体のアドレスを変えるか、シードファイルを変えて読み込み直す必要があります。

このテンプレートでのこうした書き方は、テンプレート自身の選択であり、base の設定に問題があるわけではありません。また、テンプレート全体を書き換えて検証したわけでもないので、ここでお伝えできるのは探す場所までです。直せばすべて正しくなる、とまでは保証できません。

機械が読むアドレスにも、プレフィックスがない

人が見るリンクのほかに、機械が読むものが 3 つあるので、それも確認しました。

  • /sitemap.xml に並ぶアドレスは .../sitemap-posts.xml のような形で、その中の記事アドレスは .../posts/the-case-for-static のような形です。どれにも /field-notes はありません。
  • RSS の各記事の <link> も同じく .../posts/... です。
  • ルートの /robots.txt には Disallow: /_emdash/ があり、サイトマップも指しています。一方 /field-notes/robots.txt には User-agent: * と Allow: / しかなく、/_emdash/ のブロックもサイトマップもありません。

最後の点は少し考える価値があります。検索エンジンが robots.txt を読みに行くのは、ドメインのルートだけです。サブパスの下に置いたものは、実際には誰にも読まれません。メインのサイトが EmDash でない場合は、メインサイトの robots.txt で /_emdash/ を自分でブロックする必要があります。

サイトマップや RSS にプレフィックスがないということは、検索エンジンに送るアドレスがサブパスの外のアドレスになるということです。この点は現象を確認しただけで、どのコードの何行目が決めているのかまでは追っていません。

開発モードは惑わせる

私たちは最初 astro dev でテストしていて、結果は次のとおりでした。

  • /_emdash/api/health が 500 を返し、ログには Cannot read properties of undefined (reading 'registry') と出ました。
  • /sitemap.xml が 500 を返し、内容は EmDash not configured でした。

base がランタイムを壊したのだと思いました。base を外すと、2 つのアドレスはまた 200 に戻り、確信はさらに強まりました。

ところが、先に astro build を実行して node ./dist/server/entry.mjs で起動する方法に切り替えると、base を設定した状態でも、先ほどの 2 つのアドレスは 200 を返しました。

ですから、サブパスの設定が正しいかどうかを開発モードで判断してはいけません。2 つのモードで差が出る理由は、突き止められていません。

公開前に、私たちが手で確認する箇所

  1. ビルドして起動し、curl で /field-notes/ のトップページのソースを見る。href="/ で始まるのに /field-notes を含まないリンクがないか探す。
  2. /_emdash/admin を開き、前段のルーティング規則がアプリケーションに送っていることを確認する。
  3. sitemap.xml と rss.xml の中のアドレスを見る。
  4. メインサイトの robots.txt で /_emdash/ がブロックされていることを確認する。
  5. / と /posts にアクセスして、それらを存在させたいかどうかを決める。

私たちがテストしていないこと

  • 前段のルーティング規則を、実際の Cloudflare Worker や nginx に置いては試していません。「/field-notes/* と /_emdash/* の両方を送る必要がある」という上の説明は、観察した挙動から導いたものです。
  • Cloudflare アダプターでは試していません。試したのは Node だけです。
  • テンプレート全体のリンクを書き換えきってはいません。

サブパスを使わずに済むなら、独立したサブドメインを使えば、この記事の内容のほとんどは不要になります。