URL

どのようなものか

URLはUniform Resource
Locatorの略で、日常的にはWebアドレス、あるいは単にリンクとも呼ばれま
す。資源を識別すると同時に、取得方法をソフトウェアに伝える一行のテキ
ストです。どのプロトコルを使い、どのマシンに、何を要求するかを示しま
す。ブラウザー、端末、設定ファイルに貼り付ければ、どれも追加の説明な
しに扱えます。

構成は、どのスキームにも共通する汎用構文で定まっています。

```text
https://shop.example.com:8443/orders/42?view=full#items

scheme     https
host       shop.example.com
port       8443
path       /orders/42
query      view=full
fragment   items
```

スキームは到達方法を示し、この例ではTLS上のHTTPです。ホストと省略可
能なポートが場所を、パスがそのホスト上のどの資源かを示します。クエ
リーはパラメーターを運び、通常は`name=value`の組を`&`でつなぎます。
`#`の後ろのフラグメントは、見出しや位置など、結果の内部を指します。
これはクライアント側の情報なので、ブラウザーはHTTPのリクエストター
ゲットに含めません。ただし、サーバーに対して秘密になるわけではありま
せん。クライアント側のコードが読み取り、別のリクエストで明示的に送る
ことはできます。

`/`、`?`、`#`、`&`、`=`などの文字は、この構造で役割を持ちます。その
ため、組み立てる部分の区切り文字と衝突するデータは、パーセント符号化
が必要です。`%`に続けて十六進数二桁で書きます。どの文字を符号化する
かは、その部分と構文によります。空白は`%20`、クエリーパラメーターの
値の中のアンパサンドは`%26`、パーセント記号自体は`%25`になります。
ASCII外の文字も、UTF-8のバイトとして同じ方法で運びます。パスに含まれ
るデンマーク語やウクライナ語も、この仕組みで通ります。

URLとURIは同じでしょうか。ほぼ同じですが、区別があります。URI、
Uniform Resource
Identifierは、この構文で何かを識別する文字列全般です。URLは、その中
でも所在を示すものです。一方、`urn:isbn:9780000000002`は本を識別しま
すが、取得方法は示しません。RFC
3986は、新しい仕様ではURIという語を使うよう求めています。ブラウザー
が従うWHATWG
URL標準は逆の方向を選び、URLに用語を一本化し、実装の実際の動作を記述
してRFCを置き換えることを目指しました。通常のアドレスでは両者は一致
しますが、境界的な例では異なります。ブラウザーとサーバーのライブラリ
が同じ奇妙な文字列を解析するときには、この点が重要です。

なぜ重要なのか

公開したURLは約束です。ブックマーク、検索インデックス、メール、印刷
物、チャットの履歴、他人のページに残り、そのコピーが自動で更新される
ことはありません。後からアドレスを変えると、元のアドレスが新しい場所
へリダイレクトし続けない限り、それらのリンクはすべて切れます。

そこで、早く決めておくべきなのが、アドレスを何から作るかです。変わり
やすいものは土台に向きません。ページの題名、カテゴリーの階層、製品
名、現在のフレームワークを表す拡張子などが該当します。短い識別子や、
データとして保存し、意図して編集するスラッグなら長持ちします。それで
も移動が必要になったときの方針も決めます。元のアドレスは404にせず、
恒久的なリダイレクトにします。

二つ目の判断は、アドレスに何を入れないかです。RFC
9110は、アドレスは共有のためのもので、保護のためのものではないと明言
しています。サーバーやプロキシのログ、ブラウザーの履歴、アクセス解析
に記録され、方針によっては、ページが次に読み込む相手へ`Referer`ヘッ
ダーで渡されます。セッション識別子、リセット用トークン、APIキー、個
人情報は、ヘッダーやリクエスト本文に入れます。

長さは、それほど大きな問題ではありません。HTTPの仕様は、少なくとも
8,000オクテットのアドレスを受け付けるよう実装に勧めています。十分な
長さですが、フォーム全体や直列化したフィルターをクエリー文字列に載せ
ると、その長さに達する前に、経路のどこかでもっと短い上限に当たりがち
です。

実際の活用例

このサイトの実装では、アドレスを、ページ本文より長く残るデータとして
扱います。記録された2026年8月の実装段階で、読み取り専用のSQLiteエク
スポートから三言語の実績ページ495件を生成したとき、最も影響が大き
かった判断はアドレスでした。それまでは英語の実績文の冒頭からURLを
作っていたため、文を直すだけでページが黙って移動し、そこへのリンクが
すべて切れました。そこで、実績ごと、アドレスごとに一行を持つデータと
して、アドレスを明示的に記述しました。最初の行は現在のアドレスで、そ
の後の行は、サイトがリダイレクトとして出力する旧アドレスです。記録さ
れた結果では、その段階までに公開したアドレスはすべて応答し続けまし
た。

モバイルウォレットのノートは、URLを別のURLの中で運ぶ例です。
Phantom、Solflare、BackpackはユニバーサルリンクでdAppを開きます。対
象のアドレスを自身のパスに、要求元のオリジンを`ref`パラメーターに入
れ、それぞれ`encodeURIComponent`を通します。対象に含まれる`?`や`&`を
符号化しないと解析が壊れ、ウォレットはブラウザーのタブではなくホーム
画面を開きます。`backpack://`のようなカスタムスキームを推測して使う
と、さらに悪くなります。アプリには一致する経路の登録がなく、利用者は
インストールページへ送られます。

アドレスは識別子にもなります。構造化データ963ブロックを一つのリンク
されたグラフへ置き換えたとき、組織、サイト、人物の識別子はサイトのオ
リジンから作り、一覧ページは各項目をURLだけで示すようにしました。記
録された2026年7月の実装段階では、この判断の効果も測定しました。ポー
トフォリオの一覧に各項目の内容を載せると、完全な実績文107件が必要に
なり、圧縮後のページが52%大きくなる計算でした。グラフを守る検査は、
そこに挙がるURLがすべて実際にビルドされたことを確かめます。

問題が起きるところ

URLの不具合は、目立たない傾向があります。アドレスは正しく見えても、
別の場所を指したり、意図以上の情報を明かしたりします。

符号化しないか、二重に符号化する。
戻り先を`?next=/cart?item=4&size=m`のように生のままクエリーへ入れる
と、符号化していない`&`で分かれ、サーバーは`size=m`を独立したパラ
メーターとして読みます。すでに符号化した文字列をもう一度符号化する
と、`%20`は`%2520`になり、ページには文字どおりの`%20`が届きます。各
部分をアドレスへ入れる時点で、その部分用の関数を使い、ちょうど一度だ
け符号化します。JavaScriptなら`encodeURIComponent`です。`encodeURI`
はアドレス全体を受け取る想定なので、`?`、`&`、`#`を残します。

秘密情報をクエリー文字列に載せる。
URL内のパスワードリセット用トークンやAPIキーは、アクセスログ、ブラウ
ザーの履歴、アクセス解析に複製されます。リファラーポリシーが緩けれ
ば、ページが読み込むすべての第三者へ`Referer`で送られます。認証情報
はヘッダーに入れます。リセット用メールのようにトークンをリンクで運ぶ
必要があるときは、一回限りで短時間だけ有効にし、外部へ渡さない
`Referrer-Policy`を設定します。

同じページが五つのアドレスで応答する。
`http`と`https`、`www`の有無、末尾のスラッシュの有無、`/About`と
`/about`などです。スキームとホストは定義上、大文字と小文字を区別しま
せん。パスは、サーバーが別の判断をしない限り区別します。検索エンジン
はページの評価をコピー間に分散し、キャッシュはそれぞれ保存し、アクセ
ス解析も別々に数えます。一つの形を選び、それ以外はすべて恒久的にリダ
イレクトし、その形を正規URLとして示します。

相対リンクの基準が違う。
`img/logo.png`のような参照は、現在のパスの最後のスラッシュ以降を置き
換えます。`/docs/guide`では`/docs/img/logo.png`に、`/docs/guide/`で
は`/docs/guide/img/logo.png`になります。末尾のスラッシュ一つで、ペー
ジ上の相対リンクがすべて移動します。`/`で始まるルート相対リンクな
ら、この問題を避けられます。

処理がフラグメントに依存する。
HTTPのリクエストターゲットを読むサーバー側のリダイレクト、アクセスロ
グ、アクセス解析には、`#`もその後のフラグメントも届きません。アプリ
ケーションで必要なら、クライアントが別に送れます。最初のリクエストの
一部としてサーバーへ届く必要がある情報は、パスかクエリーに入れます。

参考資料

  * RFC 3986：Uniform Resource Identifier (URI): Generic Syntax —
構文、パーセント符号化、相対参照の解決、正規化を定めています。

  * WHATWG URL標準 — ブラウザーが実装する解析アルゴリズムを、手順ご
とに記述しています。

  * RFC 3987：Internationalized Resource Identifiers —
どの文字体系で書いたアドレスも、パーセント符号化したバイトへ対応付け
る方法です。

  * RFC 8820：URI Design and Ownership —
パスの形を決めるのが、ほかの誰でもなくホストの所有者である理由を説明
します。

  * RFC 9110、第17.9節 — アドレスに含む機密情報についてのセキュリ
ティー上の注意です。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/url/	engineer.company	70
