BFF(Backend for Frontend、読み方は「ビーエフエフ」)は、Web・iOS・Androidといった画面の種類ごとに専用のバックエンドを置く設計パターンです。画面が必要とするデータを複数のサービスから集め、画面の形に整えて1回で返します。英語の「Best Friends Forever」の略語と同じ綴りですが、この記事で扱うのはシステム設計の用語のほうです。
BFFという語は、2015年に広まった「体験ごとのバックエンド」という意味に加え、2026年8月に発行されたRFC 10017で「ブラウザにトークンを渡さないOAuthクライアント」という意味でも使われています。この記事では両方の意味を切り分けたうえで、API Gateway・SSR・GraphQLとの違い、メリットとデメリット、採用と見送りの基準を整理し、Express 5で実際に動かした集約・タイムアウト・トークン秘匿のコードと実行結果を示します。
まとめ:BFFの役割と採用判断の要点
BFFは「1つのユーザー体験につき1つのバックエンド」を置き、その画面専用のAPIを公開する層です。主な用途は、複数サービスの呼び出しの集約、画面に合わせたレスポンスの整形、アクセストークンの秘匿です。用途に応じてセッション管理やキャッシュも担います。API Gatewayが認証や流量制御のような全クライアント共通の処理を受け持つのに対し、BFFは画面の変更に追従して頻繁に変わる側に立ちます。
採用の目安ははっきりしています。画面が2種類以上あり、背後が複数のサービスに分かれ、画面ごとに欲しいデータが食い違うなら、BFFは運用コストに見合います。画面が1種類で、背後のAPIが画面のデータ要件をそのまま満たすなら、集約・整形を目的とするBFFは見送るのが基本です。ただし、業務データや個人情報を扱うブラウザアプリでOAuthを使う場合は話が変わります。RFC 10017はこの用途のBFFを「strongly recommended」としており、画面が1つでもトークンをブラウザから外す目的でBFFを置く価値があります。
実装の要点は、下流1本ごとの上限時間、画面全体の締め切り、欠けてもよいデータの縮退の3点です。Node.js v26.5.0とExpress 5.3.0で試した最小構成では、レビューを返すサービスが3秒止まっても、BFFは約0.8秒で「レビュー空」の画面データを返しました。
BFF(Backend for Frontend)の意味と2つの使われ方
BFFはBackend for Frontendの略で、パターン名としては複数形の「Backends For Frontends」と書かれることも多い用語です。同じ略語が設計論とセキュリティの文脈で少し違う意味を持つため、まず語義を分けておきます。
Newmanの定義:ユーザー体験ごとに1つのバックエンド
パターンの初出は、Phil Calçado氏が2015年9月18日に公開したThe Back-end for Front-end Pattern (BFF)です。SoundCloudでの経験をもとにした記事で、同年11月18日にSam Newman氏がPattern: Backends For Frontendsとして整理しました。Newman氏は、汎用APIを1本置くとそのAPIを抱える専任チームが生まれ、画面側のチームが変更のたびに依頼待ちになる問題を出発点にしています。
分ける単位について、Newman氏の記事は「one experience, one BFF」という指針を紹介しています。分ける軸はデバイスではなく体験です。iOSとAndroidで画面設計もデータ要件もほぼ同じなら、モバイル用BFFを1本にまとめて構いません。同じWebでも、一般ユーザー向け画面と社内の管理画面で必要な項目がまるで違うなら、分けたほうが変更の影響を閉じ込められます。BFFは画面を作るチームが保守するのが前提で、画面とBFFを同じチームが同時にリリースできる点がこのパターンの核です。フロントとバックの責務の線引き自体が曖昧なら、フロントエンドとバックエンドの違いから先に押さえると、BFFが画面側の持ち物である理由が読み取りやすくなります。
RFC 10017のBFF:トークンをブラウザに渡さないOAuthクライアント
もう1つの意味は、2026年8月に発行されたRFC 10017(OAuth 2.0 for Browser-Based Applications・BCP 212)の6.1節が定義するBFFです。ここでのBFFは、ブラウザで動くアプリの代わりにOAuthの機密クライアントとして認可サーバーとやり取りし、アクセストークンとリフレッシュトークンをCookieベースのセッションの裏に保管し、APIへの要求に正しいトークンを付けて転送するサーバー側の部品を指します。RFCは「BFFはサーバーで動くが、フロントエンドアプリケーションの部品である」と書き、API Gatewayやリバースプロキシと混同しないよう注意を促しています。
この意味のBFFは、画面が1種類でも成立します。目的がデータの整形ではなく、ブラウザ内で悪意あるスクリプトが動いたときにトークンを抜かれないことにあるためです。RFC 10017は6.1.4.3節でこの構成を業務アプリ・機微なアプリ・個人データを扱うアプリに「strongly recommended」とし、6.3.4.3節ではトークンをブラウザ内に持つ構成を同じ用途に「not recommended」としています。OAuthそのものの仕組みはOAuth 2.0の仕組みとOAuth 2.1の現状で、認可コードの受け渡しは認可コードフローの実装手順で扱っています。
BFFアーキテクチャの構成とover-fetching・under-fetchingの解消
構成上のBFFは、画面とマイクロサービス群の間に立ち、その画面に合わせたAPIだけを外に出します。画面のコードは個々のサービスの所在を知らずに済み、通信の組み立てはBFFに閉じ込められます。
画面が汎用APIを直接呼ぶときに起きる2つの無駄
画面が汎用APIを直接呼ぶと、一覧に名前しか要らないのに住所や購入履歴まで受け取るover-fetchingと、1画面を描くのに商品・在庫・レビューと何度も往復するunder-fetchingが同時に起きます。BFFはこの往復とデータの選別をサーバー側に移し、画面への応答を1回にまとめます。下流との通信をBFF側にまとめることで、端末が各サービスと直接やり取りする必要が減ります。BFFと下流が近接していれば、下流との通信遅延も小さく抑えられます。
差の大きさを確かめるため、商品・在庫・レビューの3つのモックサービス(各100ミリ秒で応答)を用意し、画面から3本を順に呼ぶ場合と、後述のBFFを1回呼ぶ場合を比べました(Node.js v26.5.0・Express 5.3.0、各5回、2026年11月15日計測)。
| 呼び方 | 往復 | 所要時間(中央値) | JSON本文の受信サイズ |
|---|---|---|---|
| 画面から3本を順に呼ぶ | 3回 | 約366ミリ秒 | 2,231バイト |
| BFFを1回呼ぶ | 1回 | 約109ミリ秒 | 141バイト |
時間の差は、画面から順に呼ぶと3本分の待ちが積み上がり、BFFが並列に呼ぶと最も遅い1本分で済むことから来ています。画面側から3本を並列に呼べば、時間の差はこの表より縮まります。サイズの差は、商品説明文など画面に出ない項目をBFFが落としているためです。実回線での差は、接続の再利用、BFFと下流の配置、BFFを挟む1段分の遅延によっても変わります。
BFFの技術スタック:Node.js 26 LTS・Express・GraphQL
BFFの実装ではNode.jsとTypeScriptの組み合わせがよく選ばれます。画面と同じ言語と型定義を共有でき、画面を作るチームがそのままBFFを保守できるからです。版はNode.js公式のリリース一覧でLTSの系列を選びます。2026年11月時点では26系(Lithium)が2026年10月28日にActive LTSへ入り、24系(Krypton)は10月20日からMaintenance LTS、22系(Jod)は2027年4月30日にサポートが終わります。これから作るBFFは26系、既存の24系は2028年4月30日のサポート終了までに上げる計画を立てるのが妥当です。なお27系からはメジャーリリースが年2回から年1回に変わり、2026年11月時点ではCurrentの系列がありません(27系はalpha版で、Currentになるのは2027年4月22日の予定)。
HTTPサーバーにはExpressの5系が使えます。npmの最新版は5.3.0(2026年10月9日公開)で、要求するNode.jsは18以上です。5系ではasync関数のハンドラで投げた例外が自動でエラー処理に回るため、4系のように集約処理を毎回try/catchで包む必要がなくなりました。データ集約にGraphQLを据えるならApollo ServerやNestJSのGraphQLモジュールが出発点になります。
API Gateway・SSR・GraphQLとBFFの違い
BFFは隣り合う層と混同されやすい用語です。どれも「画面と下流の間に立つ」点は同じなので、置く単位と持つ責務で区別します。
API GatewayとBFFの違いと組み合わせ方
API Gatewayはクライアントとサービスの間で、認証・流量制御・ルーティングなどを担います。業務境界やクライアントの種類に応じて複数に分ける構成もあります。BFFは画面の種類ごとに置き、その画面専用の集約と整形を担います。
| 観点 | API Gateway | BFF |
|---|---|---|
| 分割の観点 | 業務境界・クライアント・共通制御 | ユーザー体験ごと |
| 主な責務 | 認証・流量制御・ルーティング | 集約・画面向けの整形 |
| 変更の頻度 | 低い | 画面の改修に合わせて高い |
| 保守するチーム | 基盤・インフラ | 画面を作るチーム |
両者は排他ではなく、Gatewayの内側に画面ごとのBFFを並べる構成が収まりのよい形です。Azure Architecture CenterのBackends for Frontendsパターンも、監視や認可のような横断的な機能はBFFから切り離し、Gatekeeping・Rate Limiting・Routingの各パターンで扱うよう勧めています。BFFに画面と関係のない共通処理を積むと、Gatewayとの二重持ちが始まります。Gateway側の機能と導入判断はAPIゲートウェイの役割とリバースプロキシ・サービスメッシュとの違いで詳しく扱っています。
SSR・Next.jsのRoute HandlersとBFFの切り分け
サーバーサイドレンダリング(SSR)は、サーバーでHTMLを生成する方式です。その過程で画面向けに複数APIのデータを集約する場合は、同じサーバーがBFFの役割も兼ねられます。Next.jsは公式ドキュメントにBackend for Frontendのガイドを持ち、Route Handlersとproxy(旧middleware)でこのパターンを組めると説明しています。同じガイドは、Next.jsのバックエンド機能は「完全なバックエンドの代替ではない」とも明記しています。
ガイドの注意書きには、BFFを設計するうえで見落とせない点が3つあります。Server ComponentsからはRoute Handlerを経由せずデータ元を直接呼ぶこと(ビルド時の事前描画では呼び先のサーバーが無く失敗し、実行時も余分な往復が増える)、Server Actionsはキューで逐次実行されるのでデータ取得に使わないこと、Route Handlersをサーバーレス関数として配備するとリクエスト間でデータを共有できないことです。3つ目は、後述のセッションをメモリに置く実装がサーバーレスでは成り立たないことを意味します。
切り分けの基準は「その整形結果をWeb以外のクライアントも使うか」です。モバイルアプリも同じ整形を必要とするなら、Next.jsの中に閉じ込めず独立したBFFに出します。Webだけが使うならRoute Handlersに置いたほうが運用は軽く済みます。レンダリング方式そのものの違いはSSR・CSR・SSG・ISRの違いで比較しています。
GraphQLとBFFの関係
BFFは設計パターン、GraphQLはデータ取得の仕様で、GraphQLはBFFを実装する手段の1つです。画面ごとに欲しい項目をクエリで指定できるため、over-fetchingをクライアント側の記述で抑えられます。Azureのパターン解説は、画面専用のリゾルバを持つGraphQLを既に使っている組織では、BFFを別に立てても価値が出ない場合があると書いています。GraphQLのサーバー自体が画面向けの層を兼ねているからです。GraphQLとgRPCを組み合わせてBFFを置く構成はgRPCとGraphQLの違いとBFF併用での使い分けで扱っています。
BFFのメリットとデメリット
BFFは運用するサービスを1つ増やす選択です。得られるものと払うものを並べてから判断します。
BFFのメリット:画面専用APIとチームの独立
- 画面に要る項目だけを返せる。先の計測では受信サイズが2,231バイトから141バイトに減った。
- 画面側の往復が1回になる。下流を並列に呼べば、待ち時間は最も遅い1本分で済む。
- 画面を作るチームがBFFのAPIを自分で変えられる。Newman氏が挙げる利点で、バックエンドチームへの依頼待ちが消え、モバイルアプリならストア審査を待たずにサーバー側の変更で済む修正も増える。
- OAuthのトークンをブラウザから外せる(RFC 10017の用途)。
BFFのデメリット:追加ホップの遅延・コードの重複・運用対象の増加
- ネットワークの段数が1つ増える。Azureのパターン解説は、BFFを足すときにサービスレベル目標を見直すよう求めている。
- BFF同士でコードが重複する。Azureは重複を「起こりやすい結果」と書き、Newman氏は共通化のために汎用の集約サービスへ戻すと肥大化を繰り返してきたと述べ、サービスをまたいだ重複にはある程度寛容でよいという立場を取る。
- デプロイ・監視・障害対応の対象が画面の数だけ増える。BFFが止まればその画面は全滅するので、BFF自体の冗長化も要る。
- 画面とBFFを別チームが持つと、利点だったはずのリリースの同時性が失われ、単なる中継層になる。
Node.js・Express 5によるBFFの実装と複数APIの集約
ここからは動くコードで示します。題材は「モバイルの商品詳細画面が、商品・在庫・レビューの3サービスから必要な項目だけを1回で受け取る」構成です。どのコードも、先の計測と同じモック環境で実行して挙動を確かめています。
3つのサービスを並列に呼ぶBFFの最小実装
// bff/server.js Node.js v26.5.0・Express 5.3.0で動作確認
import express from 'express';
const app = express();
const ORIGIN = process.env.SERVICES_ORIGIN; // 例: http://internal.svc.local
const PER_CALL_MS = 800; // 下流1本あたりの上限
async function getJson(path) {
const res = await fetch(ORIGIN + path, { signal: AbortSignal.timeout(PER_CALL_MS) });
if (!res.ok) throw new Error(`${path} status=${res.status}`);
return res.json();
}
app.get('/bff/mobile/product/:id', async (req, res) => {
const id = encodeURIComponent(req.params.id);
const [product, stock, review] = await Promise.allSettled([
getJson(`/products/${id}`),
getJson(`/stocks/${id}`),
getJson(`/reviews/${id}?limit=3`),
]);
// 商品本体は必須。取れなければ502を返す
if (product.status !== 'fulfilled') {
return res.status(502).json({ error: 'product_unavailable' });
}
// 在庫とレビューは欠けても画面が描ける形へ縮退させる
res.json({
id,
name: product.value.name,
price: product.value.price,
inStock: stock.status === 'fulfilled' ? stock.value.available : null,
reviews: review.status === 'fulfilled' && Array.isArray(review.value?.items)
? review.value.items.slice(0, 3) : [],
});
});
app.listen(Number(process.env.PORT ?? 3000));
このコードの肝は3つです。Promise.allSettled を使うので、下流のどれかが失敗しても他の結果は捨てません。AbortSignal.timeout(Node.js 17.3.0で追加)で下流1本ごとの上限を800ミリ秒に切っているため、画面の待ち時間が下流の最悪値に引きずられません。そして商品本体は必須、在庫とレビューは任意と分け、任意側はnullや空配列に落とします。
下流の状態を変えて5回ずつ呼んだ結果が次の表です。
| 下流の状態 | BFFの応答 | 所要時間(中央値) |
|---|---|---|
| 3本とも正常 | 200・全項目あり | 約0.11秒 |
| レビューが3秒遅延 | 200・レビュー空 | 約0.80秒 |
| 在庫が503 | 200・在庫null | 約0.11秒 |
| 商品が500 | 502 | 約0.11秒 |
| 3本とも3秒遅延 | 502 | 約0.80秒 |
レビューが止まっても、画面は800ミリ秒で「レビュー以外は揃った」データを受け取れます。上限を切らない実装なら、同じ条件で画面は3秒待たされます。必須と任意の線引きは画面の作り手と事前に合意し、画面側の分岐(在庫nullなら「在庫確認中」と出す等)を先に決めておきます。
下流APIの再試行条件と画面全体の締め切り
再試行を足すときに崩れやすいのが時間の配分です。下流1本800ミリ秒で2回試せば最悪1.6秒かかり、画面の目標が1.2秒なら守れません。そこで「1回あたりの上限」と「画面全体の締め切り」の2つの信号を AbortSignal.any(Node.js 20.3.0で追加)で束ね、早いほうで打ち切ります。
// bff/callDownstream.js 画面全体の締め切りの中で、一時障害だけ1回やり直す
const RETRYABLE = new Set([502, 503, 504]);
export async function callDownstream(url, { requestId, deadline, perTryMs = 500 }) {
for (let attempt = 1; ; attempt++) {
let res;
try {
res = await fetch(url, {
// 1回分の上限と画面全体の締め切りの、早い方で打ち切る
signal: AbortSignal.any([AbortSignal.timeout(perTryMs), deadline]),
headers: { 'x-request-id': requestId },
});
} catch (err) {
// 接続失敗と1回分の超過はやり直す。2回目か締め切り後なら諦める
if (attempt === 2 || deadline.aborted) throw err;
continue;
}
if (res.ok) {
try {
return await res.json();
} catch (err) {
if (attempt === 2 || deadline.aborted ||
!['TimeoutError', 'AbortError', 'TypeError'].includes(err.name)) throw err;
continue;
}
}
await res.body?.cancel();
if (attempt === 2 || !RETRYABLE.has(res.status)) {
throw new Error(`${url} status=${res.status}`); // 4xxと500はやり直さない
}
}
}
// bff/server.js の呼び出し側(既存ハンドラと差し替え)
import { randomUUID } from 'node:crypto';
import { callDownstream } from './callDownstream.js';
app.get('/bff/mobile/product/:id', async (req, res) => {
const id = encodeURIComponent(req.params.id);
const requestId = req.get('x-request-id') ?? randomUUID();
// 画面1回分の持ち時間。3本の呼び出しで同じ締め切りを共有する
const deadline = AbortSignal.timeout(1200);
const opts = { requestId, deadline };
const [product, stock, review] = await Promise.allSettled([
callDownstream(`${ORIGIN}/products/${id}`, opts),
callDownstream(`${ORIGIN}/stocks/${id}`, opts),
callDownstream(`${ORIGIN}/reviews/${id}?limit=3`, opts),
]);
// 以降の必須・任意の振り分けは最小実装と同じ
});
1回500ミリ秒・全体1.2秒の設定で試した結果は次のとおりです。
| 下流の状態 | BFFの応答 | 所要時間(中央値) | 下流への要求数 |
|---|---|---|---|
| 在庫が初回だけ503 | 200・在庫あり | 約0.11秒(初回約0.27秒) | 初回2回、以降1回 |
| 在庫が常に503 | 200・在庫null | 約0.21秒 | 在庫は2回 |
| 在庫が3秒遅延 | 200・在庫null | 約1.0秒 | 在庫は2回 |
| 商品が404 | 502 | 約0.11秒 | 商品は1回 |
| 商品が700ミリ秒で正常応答 | 502 | 約1.0秒 | 商品は2回 |
最後の行が設定値の決め方を物語っています。商品サービスは正常に700ミリ秒で返しているのに、1回の上限500ミリ秒に毎回引っかかり、2回とも打ち切られて画面は502になりました。1回あたりの上限は、下流が正常なときの応答時間の上位(p99など)より長く取らないと、再試行は負荷を倍にするだけの仕組みになります。設定値は下流ごとの実測の分布から決め、全サービス一律の値にしないことです。
再試行の対象を502・503・504と接続失敗に限っているのは、404や400のような要求そのものの誤りはやり直しても結果が変わらないからです。x-request-id を受け取ってそのまま下流へ渡しておくと、画面で起きた遅延がどの下流で生じたかをログで横断して追えます。下流の障害が続いて全体を巻き込む段階では、呼び出し自体を一定時間止めるサーキットブレーカーを挟む判断に移ります。
トークンをブラウザに置かないBFFの実装とRFC 10017の要件
セキュリティ目的のBFFでは、ブラウザに渡すのはセッションを識別するCookieだけで、アクセストークンはBFFのサーバー側に置きます。RFC 10017の6.1節は、このとき満たすべき要件をCookieの属性、CSRF対策、転送先の制限に分けて定めています。
Cookieの属性とセッションの置き場所
// bff/session.js トークンはBFFのサーバー側だけに置き、ブラウザにはCookieのIDだけを渡す
import express from 'express';
import cookieParser from 'cookie-parser';
import { randomUUID } from 'node:crypto';
const app = express();
app.use(cookieParser());
const ORIGIN = process.env.SERVICES_ORIGIN;
const SID = '__Host-Http-sid';
const sessions = new Map(); // 本番はRedis等の外部ストアに置く
// 状態を変えない要求も含め、全APIに独自ヘッダーを必須にする(CORSでCSRFを止める前提)
app.use('/bff/api', (req, res, next) => {
if (req.get('x-bff-csrf') !== '1') return res.status(403).json({ error: 'csrf' });
next();
});
// 認可コードフローの完了後に呼ばれる想定(コード交換の処理は省略)
app.get('/bff/callback', (req, res) => {
const sid = randomUUID();
sessions.set(sid, { accessToken: 'at-' + randomUUID() });
res.cookie(SID, sid, { httpOnly: true, secure: true, sameSite: 'strict', path: '/' });
res.redirect('/');
});
app.get('/bff/api/me', async (req, res) => {
const session = sessions.get(req.cookies[SID]);
if (!session) return res.status(401).json({ error: 'unauthenticated' });
const upstream = await fetch(`${ORIGIN}/users/me`, {
headers: { authorization: `Bearer ${session.accessToken}` },
signal: AbortSignal.timeout(800),
});
if (!upstream.ok) return res.status(502).json({ error: 'upstream' });
const me = await upstream.json();
// 返すのは画面に要る項目だけ。トークンもメールアドレスも返さない
res.json({ id: me.id, displayName: me.display_name, plan: me.plan });
});
app.listen(Number(process.env.PORT ?? 3000));
Cookieの属性はRFC 10017の6.1.3.2節に沿っています。SecureとHttpOnlyはMUST、SameSite=Strict・Pathを「/」にすること・Domain属性を付けないこと・__Host-Http- のような接頭辞を付けることはSHOULDです。__Host- で始まる名前のCookieは、ブラウザがSecure付き・Path=/・Domain無しの条件を満たさない限り受け付けないため、サブドメインからのセッション固定攻撃を防げます。実行すると、応答ヘッダーは Set-Cookie: __Host-Http-sid=…; Path=/; HttpOnly; Secure; SameSite=Strict となりました。
セッションの保管にMapを使っているのは動作確認のためです。BFFを複数台で動かす場合や、Next.jsのRoute Handlersをサーバーレスに配備する場合はリクエスト間でメモリを共有できないため、Redisなどの外部ストアに置きます。トークンをCookieの中身に暗号化して持たせる方式を取るなら、RFCはCookieの暗号化をSHOULDとしています。
CSRF対策と転送先の許可リスト
Cookieで認証する以上、BFFにはCSRF対策がMUSTです(6.1.3.3節)。SameSite=Strictだけでは、同じ登録ドメイン配下の別サブドメインが乗っ取られた場合に防げません。RFCが勧めるのは、すべての要求に固定値の独自ヘッダーを必須にする方法です。独自ヘッダー付きのクロスオリジン要求はブラウザが必ずプリフライトを送るため、BFFが許可しない限り本番の要求は送られません。上のコードで x-bff-csrf: 1 を検査しているのがこれに当たり、ヘッダー無しの要求は403、Cookie無しの要求は401、両方そろった要求だけが200になることを確認しました。画面とBFFを同じオリジンに置けば、正規の要求にプリフライトは発生しません。プリフライトの仕組みはCORSの仕組みとプリフライトで解説しています。
もう1つの要件が転送先の制限です(6.1.3.6節)。BFFは受けた要求にトークンを付けて転送するため、転送先を要求のパスから組み立てると、攻撃者に任意のサーバーへトークンを送らせる余地が生まれます。RFCは許可するホストとパスを明示したリストで照合することをMUSTとしています。Next.jsのBFFガイドも、パスと転送先を固定の対応表で引き、要求のURLから転送先を作らない例を載せています。
BFFを採用すべき条件と見送る条件
ここまでの性質を踏まえ、採用と見送りの境界を条件で示します。
BFFの導入が運用コストに見合う条件
次の3つが重なるほど、BFFは元が取れます。
- 画面が2種類以上あり、画面ごとに欲しいデータの形が違う(Web・iOS・Android、一般向けと管理画面など)。
- 背後が複数のサービスに分かれ、1画面あたりの呼び出し先が3つ以上ある。
- 画面を作るチームがBFFも保守でき、画面とBFFを同時にリリースできる。
3つ目が欠けると、BFFは誰も持ち主のいない中継層になります。体制が整わないうちは、先にチームの持ち分を決めてから層を足す順番にします。構成の設計から実装体制まで外部と詰めたい場合は、API開発・システム連携で構成段階から相談できます。
小規模な構成でBFFが過剰投資になる場面
Azureのパターン解説が「適さない」と挙げるのは、各画面が同じか似た要求を出す場合と、バックエンドとやり取りする画面が1つしかない場合です。背後が1つのアプリケーションでも、複数APIの集約や画面向けの整形が必要ならBFFは候補になります。それらが不要なら、監視とデプロイの追加負担に見合う役割があるかを確認します。仕様が固まっていない立ち上げ期も、変更のたびに画面・BFF・サービスの3か所を直すことになるので見送り側です。この段階ではNext.jsのRoute Handlersのような組み込みの層で済ませ、2種類目の画面が決まった時点で独立させます。背後をモノリスとマイクロサービスのどちらで組むかが未整理なら、マイクロサービスとモノリスの違いを先に決めると、BFFの要否も判断しやすくなります。
例外は、OAuthで業務データや個人データを扱うブラウザアプリです。画面が1つでも、トークンをブラウザから外す目的のBFFはRFC 10017が強く勧める構成なので、「画面が1つだから不要」で片付けないでください。
BFFの運用で起きやすい失敗パターン
- 中継化:データ集約を目的に置いたBFFが、集約も整形もせず要求を下流へ流すだけになる。トークン管理などの役割もなければ、削除を検討します。
- 共有BFFの肥大化:全画面の処理を1つのBFFに集め、ある画面の変更が別の画面を壊すようになる。Newman氏が「汎用の集約サービスへ戻すと肥大化する」と警告している形です。
- 業務ロジックの流入:値引き計算や在庫引当のような業務ルールをBFFに書き始め、下流サービスと責務が二重になる。業務ルールはサービス側へ戻します。
コードレビューでは「このハンドラは下流を2本以上呼んでいるか、または返す項目を絞っているか」を確かめると、中継化を早く見つけられます。どちらにも当たらないハンドラでも、トークンをブラウザに渡さずAPI呼び出しを代理する役割があれば、BFFに置く理由があります。画面そのものをチームごとに分割する段階まで進むなら、マイクロフロントエンドの分割単位と統合方式とあわせて、BFFを画面の分割単位にそろえるかを検討します。
BFFについてよくある質問
BFFは何の略ですか?
IT用語ではBackend for Frontend(またはBackends For Frontends)の略で、「ビーエフエフ」と読みます。若者言葉の「BFF」はBest Friends Forever(ずっと親友)の略で、綴りが同じだけの別の言葉です。
APIとBFFの違いは何ですか?
APIはプログラム同士がやり取りする窓口の総称で、BFFはその窓口を画面の種類ごとに専用で用意する設計パターンです。BFF自体もAPIを公開しますが、そのAPIは特定の画面のためだけに作られ、他の画面からの利用を想定しません。
フロントエンドが1つでもBFFは必要ですか?
データの集約や整形が目的なら、画面が1つで、背後のAPIが画面に必要な形でデータを返している限り不要です。OAuthのトークンをブラウザに置きたくないという目的なら、画面が1つでも置く価値があります。RFC 10017は業務アプリや個人データを扱うアプリにこの構成を強く勧めています。
BFFはNode.js以外の言語でも実装できますか?
実装できます。GoやKotlin、Javaで書く例もあります。Node.jsとTypeScriptが選ばれやすいのは画面と型定義を共有できるからで、BFFを保守するのが画面を作るチームである以上、そのチームが書ける言語で選ぶのが筋です。
BFFは誰が開発・運用しますか?
原則として、そのBFFを使う画面を作るチームです。Newman氏はBFFを画面と同じチームが保守することで、APIの変更と画面のリリースを揃えられる点を利点に挙げています。運用の負荷は増えるので、BFFごとに応答時間とエラー率を見るダッシュボードを最初から用意しておきます。