1 / 4概念
BFF
BFF(Backend for Frontend)是为一个客户端体验服务的边缘后端。它把多个领域服务的响应裁剪、聚合、缓存成客户端刚好需要的形状;它不拥有领域规则,也不应该成为第二个业务后端。
1 概念
1.1 一句话定义
BFF 是位于客户端与领域服务之间的适配层,按某个客户端(Web、移动端、第三方)的交互方式聚合和裁剪 API,并承担该客户端的认证、缓存、降级和错误映射。一个客户端体验通常对应一个 BFF。
1.2 它解决什么问题
- 移动端只需要少量字段,通用 API 却返回整页 JSON,流量和渲染都浪费。
- 一个页面要调 6 个服务,客户端承担编排、重试和错误处理,逻辑重复且难改。
- Web 与移动端的会话、缓存、错误码不同,硬塞进一个通用 API 会互相牵制。
- 第三方合作方需要稳定的契约,而内部服务频繁重构。
BFF 把“客户端怎么用”从“领域是什么”里分离出来;代价是多一个部署单元和一层网络。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 服务发现、数据所有权、跨服务事务 | Microservices |
| 限界上下文、聚合与领域规则 | Domain-Driven Design |
| 事件、CQRS 与最终一致性 | Event-Driven Architecture |
| 前端框架的组件与状态 | Frontend Frameworks |
| 通用 API 网关的限流与 TLS | Microservices |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| BFF | 面向单个客户端的后端适配层 | 不是通用 API 网关 |
| API 网关 | 统一入口、认证、限流、路由 | 不负责客户端特定聚合 |
| 聚合 | 把多个下游响应合成一个 | 不是领域层的事务聚合 |
| 契约 | BFF 对客户端的稳定接口 | 不是内部服务的 proto |
| N+1 | 一次请求触发多次下游调用 | 不一定来自循环,可能来自解析器 |
| DataLoader | 批量加载与请求级缓存 | 不是全局缓存 |
| 缓存键 | 决定命中与隔离的标识 | 不能忽略用户/租户维度 |
| 部分失败 | 某些下游失败时仍返回可用结果 | 不是“全部重试” |
2 机制
2.1 心智模型
BFF 是客户端的专用镜头:同一份领域数据,Web 镜头看全景,移动端镜头看摘要,第三方镜头看稳定契约。镜头可以换,领域模型不能被镜头改写。
一条不变量:BFF 只做编排、裁剪、缓存和协议适配;业务不变量属于领域服务。如果 BFF 开始决定“订单能不能支付”,它就已经越界。
2.2 机制拆解
- 客户端请求 BFF,BFF 完成会话/令牌校验。
- BFF 按客户端需求并发调用多个领域服务(REST/gRPC)。
- BFF 聚合、裁剪、重命名字段,补齐客户端需要的展示信息。
- BFF 按用户/租户/语言维度写缓存;读缓存命中则直接返回。
- 下游失败时按策略降级:返回部分数据、缓存旧值或明确错误。
- BFF 记录下游耗时、fan-out 数和错误,供客户端与服务端共同排障。
GraphQL BFF 用 schema 表达客户端可查询的形状,resolver 负责取数;REST BFF 用固定端点表达页面级聚合。两者都可以,关键是契约归 BFF 所有。
2.3 完整枚举
| 维度 | 成员 | 关键属性 | 适用场景 |
|---|---|---|---|
| 客户端类型 | Web BFF、移动 BFF、第三方 BFF、SSR BFF | 会话、缓存、字段裁剪不同 | 多端体验差异大 |
| 协议 | REST、GraphQL、tRPC、gRPC-Web | 契约表达力与工具链 | 按客户端能力选 |
| 认证 | 令牌透传、令牌交换、会话 Cookie、API Key | 信任边界与权限范围 | 浏览器/移动/合作方 |
| 聚合 | 并行 fan-out、串行依赖、批量加载、预计算 | 延迟与一致性 | 页面级组合 |
| 缓存 | HTTP 缓存、CDN、进程内、Redis | 命中率与失效策略 | 读多写少 |
| 降级 | 部分返回、旧值、默认值、明确错误 | 用户体验与可观测性 | 下游不稳定 |
| 契约管理 | schema 版本、弃用字段、契约测试 | 兼容与演进 | 多客户端长期维护 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| fan-out 数 | 3–10 | 超过 10 要重新设计页面或预计算 |
| BFF 自身开销 | 1–5 ms | 主要是序列化与聚合 |
| 客户端 P95 | 下游 P95 + 聚合开销 | 串行依赖会累加 |
| 缓存命中率 | 70%–95% | 取决于个性化程度 |
| 响应体积 | 减少 30%–80% | 相对通用 API 的典型收益 |
| N+1 放大 | 列表长度 × 下游调用 | 用批量加载消除 |
3 实践
3.1 最小示例
// GraphQL BFF:schema 归 BFF 所有,resolver 只做聚合与裁剪。
import DataLoader from 'dataloader';
type Order = {id: string; customerId: string; totalCents: number};
type Customer = {id: string; name: string};
const customerLoader = new DataLoader<string, Customer>(async (ids) => {
const rows = await customerService.getMany([...ids]);
const byId = new Map(rows.map((row) => [row.id, row]));
return ids.map((id) => byId.get(id) ?? new Error(`customer ${id} not found`));
});
export const resolvers = {
Order: {
total: (order: Order) => order.totalCents / 100,
customer: (order: Order) => customerLoader.load(order.customerId),
},
Query: {
orders: async (_: unknown, args: {first: number}, ctx: {userId: string}) => {
const page = await orderService.listByUser(ctx.userId, args.first);
return page.items;
},
},
};
3.2 常用操作与参数
| 操作 | 命令 / API | 说明 |
|---|---|---|
| 查看 schema | GraphQL introspection / graphql-codegen | 契约即文档 |
| 批量加载 | DataLoader | 请求级缓存,避免 N+1 |
| 缓存响应 | Cache-Control / CDN | 注意 Vary 与用户维度 |
| 令牌交换 | OAuth token exchange | 不把用户令牌直接传给所有下游 |
| 契约测试 | 对 schema 做快照/兼容检查 | 防止字段被误删 |
| 降级 | 超时 + 回退值 | 明确返回 partial: true |
3.3 标准流程
- 先列客户端页面和每个页面的数据需求。
- 决定 BFF 的数量:按客户端体验拆,不按团队数量拆。
- 定义 BFF 契约(REST 端点或 GraphQL schema),标出必填、可选和弃用字段。
- 为每个下游调用设超时、并发上限和降级策略。
- 设计缓存键:用户、租户、语言、权限一个都不能少。
- 用真实设备/网络做端到端验证,观察 fan-out、P95 和负载体积。
3.4 与相邻技术的组合
- 微服务:BFF 编排多个服务,但不替代服务发现和网关。
- DDD:领域规则留在上下文内;BFF 只做展示模型,不做业务决策。
- 前端框架:BFF 的契约直接决定前端的数据获取方式,GraphQL 适合多视图,REST 适合页面级缓存。
- 可观测性:BFF 要记录每个下游的耗时和失败,否则客户端慢无法定位。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 客户端数量 | 1 / 多 | 多端才需要多个 BFF |
| 体验差异 | 小 / 大 | 差异大才值得拆 |
| 页面聚合度 | 低 / 高 | 高聚合适合 BFF |
| 缓存需求 | 弱 / 强 | 强缓存要设计键与失效 |
| 团队边界 | 前端/后端同队 / 分离 | 同队沟通成本低 |
| 契约稳定性 | 内部 / 外部 | 外部契约需要版本治理 |
3.6 决策规则
- 只有一个 Web 客户端、调用简单:先不要 BFF。
- 多端字段/流程差异大:按客户端体验拆 BFF。
- 页面需要聚合 3 个以上服务:BFF 收益明显。
- 需要强缓存和边缘加速:BFF + CDN,缓存键必须含用户/租户维度。
- 下游协议不统一:BFF 做协议适配,但不要把转换写成业务规则。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| 通用 API | 简单、一个契约 | 字段冗余、客户端编排 | 单客户端、简单页面 |
| API 网关聚合 | 少一个部署单元 | 网关变巨石、难按端演进 | 少量固定聚合 |
| BFF | 按端裁剪、缓存与降级 | 多一层部署与契约 | 多端、复杂页面 |
| GraphQL 联邦 | 统一图、跨服务查询 | 治理复杂、N+1 风险 | 多团队、多服务 |
| 客户端直连 | 延迟低、链路短 | 编排与错误处理在客户端 | 内部工具、简单场景 |
3.8 何时不该用
- 只有一种客户端,且页面只调一个服务:BFF 是多余的一跳。
- 团队没有契约治理:多个 BFF 会迅速分叉出不一致的字段。
- 把 BFF 当领域服务:规则会重复,最终没人知道哪份是对的。
- 缓存键设计不了:个性化页面缓存会串用户,风险高于收益。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| BFF 越来越像业务后端 | 领域规则被写进 resolver | 规则下沉回领域服务 |
| 列表页 P95 飙升 | resolver 循环调用下游,N+1 | DataLoader/批量接口 |
| 用户看到别人的数据 | 缓存键缺少用户/租户维度 | 缓存键加维度,敏感数据不缓存 |
| 登录后大量 401 | 令牌透传范围或受众不匹配 | 令牌交换/正确 audience |
| 字段删除导致旧客户端崩溃 | 契约无版本/弃用流程 | 先弃用、再观察、后删除 |
| 一个下游慢拖垮整页 | 无超时/无部分返回 | 超时、并发上限、部分降级 |
| 多端行为不一致 | BFF 复制了业务逻辑 | 共享领域服务,BFF 只做适配 |
| GraphQL 查询被滥用 | 无深度/复杂度限制 | 查询白名单、深度与成本限制 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 每个团队一个 BFF | 同一客户端多套契约 | 按客户端体验拆 |
| BFF 直接连数据库 | 绕过领域边界 | 只调领域服务 |
| 把下游错误原样透传 | 客户端无法处理 | 映射成稳定错误码 |
| 全局缓存用户数据 | 串号与隐私事故 | 用户维度键 + 短 TTL |
| 无限制 GraphQL 查询 | 数据库被打穿 | 成本分析 + 限流 |
4.3 可观测信号
每个下游的调用量、P50/P95、错误率、fan-out 数、缓存命中率、BFF 自身耗时、GraphQL 查询成本、部分降级比例。按客户端版本和页面维度看,不要只看 BFF 总量。
4.4 安全 / 性能 / 一致性边界
- 安全:BFF 是信任边界;校验令牌、限制字段、避免把内部错误和堆栈透给客户端。
- 性能:BFF 的 fan-out 会放大下游压力;并发上限和批量加载是硬约束。
- 一致性:BFF 聚合多个服务时可能读到不同时间点的数据;对一致性敏感的页面要标注或走单一读模型。
- 契约:BFF 的契约归客户端所有,删除字段必须经过弃用周期。