言語対応は片方向だった

「みやこでIT」のサイトには、日本語ページと対になる英語ページがあります。検索エンジンにその対応を伝えるのが、HTMLのheadに出すhreflangの指定です。2026年10月31日の点検で、日本語の5ページがこの指定を出していないことが分かりました。本稿で扱うのは、そのうち修正した3ページです。英語ページの側は日本語ページを指しているのに、日本語ページの側からは英語ページを指していない。対応関係が片方向になっていました。

ここでは、その不具合をどう確かめ、どこを直し、本番で何を確認したかを記録します。変更はPR #382で、2026年11月2日に本番へ反映しました。検索流入や参加への効果は、まだ測っていません。

見つかった場面

きっかけは、検索まわりの施策を追跡しているIssue #349での公開ページの点検です。10月31日に日英の主要22URLを取得し直すと、すべてHTTP 200で、titleとdescriptionもそろっていました。一方で、日本語の5ページはheadのhreflangが0件で、対応する英語ページは各3件を出していました。

PR #382で直したのは、そのうち次の3組です。

英語側はja・en・x-defaultの3つを出し、日本語側はcanonicalだけ。同じペアなのに、片方だけが「対になるページがある」と伝えていました。サイトのi18n設計でも、片側だけのhreflangは禁止しています。

原因はページごとの直書き

サイトには、canonicalとhreflangをまとめて組み立てる共通関数 buildAlternates があります（lib/i18n/metadata.ts）。英語ページはこの関数を通していました。ところが3つの日本語ページは、古い書き方のまま、canonicalだけを直接書いていました。

関数の動きは次のとおりです。

• 日本語と英語の絶対URLを組み立て、表示中の言語のURLをcanonicalにする
• 英語版の全体公開フラグが無効か、対象ルートが英語の品質確認を通っていなければ、canonicalだけを返す
• 公開の条件を満たすときは、ja・en・x-defaultの3つを返す。x-defaultは日本語URL

公開してよいかの判定を関数の中に集めてあるので、ページ側でhreflangを手書きする必要はありません。直書きのページだけが、この判定の外にありました。

変更は3ファイルとも同じ形

修正は、3つの日本語ページのmetadataを共通関数に置き換えることです。FAQページの差分は次のとおりです（import行の追加を除く）。

• 変更前 alternates: { canonical: "https://www.miyakodeit.com/faq" },
• 変更後 ...buildAlternates("/faq", "ja"),

/sponsor と /guides/kyoto-mokumoku も、それぞれのパスで同じ置き換えをしました。本文、CSS、CTA、title、description、OGP、構造化データは変えていません。PR全体は6ファイルで、残る3つは回帰テスト、表示確認の記録、作業の学びを残すLEARNINGSです。

テストは実際のページ定義を読む

回帰テスト（__tests__/lib/reciprocal-hreflang.test.ts）は、共通関数だけを試すのではなく、日英それぞれのページファイルが実際にexportしているmetadataを読み込みます。関数が正しくても、ページが使っていなければ不具合は残るからです。

検査は1組につき2条件、3組で計6ケースです。

• 英語公開がONのとき、日本語ページと英語ページが、それぞれ自分自身のcanonicalと、まったく同じja・en・x-defaultの組を出す
• 英語公開がOFFのとき、どちらもcanonicalだけを出す

修正前のソースに戻して同じテストを実行すると、公開ONの3ケースがhreflangの欠落で失敗し、公開OFFの3ケースは成功しました。修正後は6ケースすべてが成功しています。テストが通るだけでなく、この不具合を実際に検出できることを、失敗する入力で確かめました。

本番での確認

PR #382は、次の順で受け入れました。

HTTP 200が返るだけでは、反映の証拠になりません。headに出ているcanonicalとhreflangそのものを、6URLすべてで読みました。

まだ分かっていないこと

確認できたのは、実装、テスト、CI、独立QC、本番HTMLまでです。次のことは、まだ分かっていません。

• 検索エンジンがこの対応関係をいつ、どう扱うか
• 検索の表示回数やクリック、英語ページからの参加や相談が増えるか

これらは公開後に同じ長さの期間どうしで比べて確かめる予定で、今回の修正の成果には数えていません。

10月31日の点検では、/first-time と /contact の日本語ページもhreflangが0件でした。この2ページはPR #382の対象外で、2026年11月2日時点のmainのソースでも、日本語側はcanonicalだけを出しています。英語側は共通関数を通しているため、同じ片方向が残っています。別の作業で扱います。

同じ不具合を探すときは

英語版のあるサイトなら、次の手順で同じ片方向を見つけられます。

• 日本語ページと英語ページの両方のHTMLを取得し、headのhreflangを数える。片方だけ0件なら片方向
• canonicalやhreflangをページごとに直書きしている箇所を検索し、共通関数に寄せる
• テストは共通関数だけでなく、実際のページ定義を読む。修正前に戻すと失敗することも確かめる

「みやこでIT」では、こうしたサイト改善の作業も記録として公開しています。似た作業を進めている方は、イベント一覧からもくもく会を探して、作業の続きを持ち込んでみてください。