バックエンド

どのようなものか

バックエンドは、運営者が管理するマシンで動く部分です。データを保持
し、誰に何を許すかのルールを適用し、ブラウザー、アプリ、他のサービス
からの要求に答えます。英語ではback
end、back-endとも書き、同じ領域をサーバー側とも呼びます。

HTTPでは、RFC
9110が「指定した対象リソースについて、権威ある応答を生成できるプログ
ラム」とするオリジンサーバーに当たります。W3CのArchitecture
of the World Wide
Webは、利用者側の見方を加えます。URIがリソースを識別し、ブラウザーへ
届くのは、その状態の情報を符号化した表現です。顧客には注文ページが見
えますが、注文、在庫、支払いを保持し、返答に入れるものを決めるのは
バックエンドです。

通常、フロントエンド、モバイルアプリ、他社のシステムが呼べる、HTTPエ
ンドポイント群のAPIを公開します。APIの仕様は、経路、入力、出力、エ
ラーを定めます。OpenAPI
Specificationは、言語に依存せず書き、クライアント、文書、テストを生
成できる、一般的な記述方法です。背後では、要求処理、業務ロジック、保
存などの層に分けます。

なぜ重要なのか

最初の問いは、要求のたびに動くバックエンドが、そもそも必要かです。全
訪問者に同じページなら、一度生成してファイルで提供できます。注文、ロ
グイン、非公開データの検索など、何かを変える、または要求者によって答
えが変わる場合に、役立ちます。インターネットの要求に答えるソフトウェ
アには、防御、修正、料金が必要で、継続費用も生じます。

二つ目は信頼です。管理下のマシンで動くため、ルールを強制できる唯一の
場所になります。直接要求を送る人は、フロントエンドの確認を回避できま
す。そのため、価格から権限まで、重要な各ルールを、ログインした利用者
と具体的な記録に対して、サーバーで確認します。OWASP
Application Security Verification Standardは、それを、実装・検査でき
る要件にしています。

三つ目はロジックの置き場所です。一つのルールがハンドラー、サービスク
ラス、データベーストリガーに散れば、変更先も、ずれるコピーも三つにな
ります。コードにルールを置き、データベースを保存だけに使うチームも、
データベースへルールとデータ成形を移してAPIを薄くするチームもありま
す。各ルールの置き場所が一つに定まっていれば、どちらも機能します。

四つ目は利用側とのインターフェース仕様です。HTTPは各応答に意味の定
まったステータスコードを与え、利用側、プロキシ、監視が従います。422
Unprocessable Contentは、構文と形式は正しいが、過去の日付の予約な
ど、意味に問題があることを示します。RFC
9457は、problem
detailsという標準のエラー本文を加えます。type、title、status、
detail、instanceを持つ小さなJSONを`application/problem+json`として送
り、文章を解析せず失敗を区別できるようにします。

実際の活用例

通常、データベースからブラウザーまでは変換のリレーです。APIが行を構
造体に読み、組み替え、JSONへ戻します。あるプラットフォームでは、デー
タベースが応答を組み立て、そのまま渡します。データのある場所で
PostgreSQL関数が全体をJSONにし、Goハンドラーは`json.RawMessage`とし
て受け、そのまま送ります。小さな`QueryJSON`補助関数によって、それが
最も簡単な経路になりました。DTO、マッパー、応答構造体が不要になり、
ハンドラーは大幅に短くなり、関数の出力変更は、ハンドラーを編集せず利
用側まで届きます。

入力にも、データベースから外へつながるAPI仕様で、同じ一つの正本を使
います。スキーマと関数がデータの形を、Go型がAPIを定義します。Humaが
型からOpenAPIを出力し、そこから44,076行の型付きTypeScriptで書かれ
た、フロントエンド用のクライアントを生成します。画面でフォームに適用
する制限も、バリデーターに制限値を手入力し直すのではなく、同じ場所か
ら取得します。各段階の検査で、一方だけのフィールド変更は、数分後のビ
ルドで失敗します。そのために必要な手間は、再生成です。バックエンドの
形を変えるたび、後続の各段階を生成し直し、変更を伝える必要がありま
す。

記録された設計段階では、このサイトは逆の選択をしました。すべてビルド
時に生成し、リクエストを処理するアプリケーションのバックエンドを必要
としませんでした。三言語での動作と、別料金のアプリケーションサービス
を使わないことを含む四つの要件から、この方式を選びました。リクエスト
時に動くアプリケーションのバックエンドには、防御、更新、プライバシー
ページでの説明が必要になるためです。記録にあるポートフォリオのフィル
ター用の限定的なJavaScript例外を除き、対話的な機能はビルド時に解決す
るか、省く必要がありました。これは記録された設計段階の説明であり、現
在のサイトの構成や実装を示すものではありません。ホスティングに費用が
かからなかったという意味でもありません。

問題が起きるところ

想定外の要求が来るまで、静かなままになりがちです。

他人の記録を変更できます。
ログインだけを確認し、URLのIDを読み込むと、要求の`/invoices/1041`を
`/invoices/1042`へ変えるだけで済みます。全ハンドラーが通る一か所で、
触れる全オブジェクトの所有権・権限を確認し、他のアカウントの記録に
403か404を期待するテストを残します。

操作が二度起きます。 GETで取り消すリンクを、クローラーや先読みするブ
ラウザーがたどり、クリックなしで動きます。RFC
9110がGET、HEAD、OPTIONS、TRACEを安全とするのは、クローラーや先読み
が害を恐れず使えるためです。別の経路は再試行で、決済が時間切れにな
り、再送して二重払いします。状態変更はPOST、PUT、PATCH、DELETEに置
き、再試行する書き込みには、サーバーが覚えるキーを与え、二つ目には最
初の結果を返します。

全エラーが500、または本文にエラーを含む200です。
共通ハンドラーが同じ返し方をし、監視は入力ミスを障害と数え、再試行は
必ず失敗する要求を繰り返します。入力は400・422、本人確認と権限は
401・403、リソースが見つからない場合は404、競合は409、サーバー自身の
問題だけを5xxへ対応させます。詳細はproblem
detailsで送ります。

```json
{
    "type": "https://example.com/problems/booking-in-past",
    "title": "Booking date is in the past",
    "status": 422,
    "detail": "The date 2026-10-01 is before today.",
    "instance": "/bookings/8812"
}
```

RFC 9457は、problem
detailsは「内部実装のデバッグツールではない」とするため、スタックト
レースとSQLはサーバーのログに残します。

データ増加でページが遅くなります。
注文一覧を取得し、各顧客を個別に問い合わせると、50件の注文があるペー
ジでは、データベースとの往復が51回必要です。開発の十行では速くても、
本番の一万行では遅くなります。結合で一度に取得するか、全応答をデータ
ベースで組み立て、応答時間と同じように、要求ごとのクエリ数を監視しま
す。

参考資料

  * Architecture of the World Wide Web, Volume
One：リソース、表現、安全・非安全な操作のW3C勧告です。

  * RFC 9110：HTTP Semantics：メソッド、ステータス、安全性・冪等性の
IETF標準です。

  * OpenAPI Specification：人とコード生成器が読む、言語に依存しない
HTTP APIの記述形式です。

  * RFC 9457：Problem Details for HTTP APIs：機械可読のエラー応答
の、標準JSON形式です。

  * OWASP Application Security Verification
Standard：ウェブアプリの構築とテストのためのセキュリティ要件です。

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