BFF 是什么,为什么需要它
🎯 引言
一个订单详情页需要订单金额、用户昵称和商品名称。如果三个接口分别由前端调用,页面就需要处理请求顺序、数据拼接和多个失败状态。Web 页面做一次,移动端又做一次。本课程用 Node.js 和 Express 把这些重复工作集中到 BFF,再逐步拆出能独立运行的业务服务。
阅读本篇后,你将能说明 BFF 在请求链路中的位置,区分页面数据适配与业务规则,并判断自己的项目是否需要增加这一层。
你需要先掌握 Node.js、Express 路由、HTTP 状态码和数据库的基本操作。本课程不重新讲这些基础;第一次出现的架构概念会结合订单案例解释。
⚠️ 前端分别调用多个接口会遇到什么问题
以订单详情页为例,订单接口返回金额、用户 ID 和商品 ID,但页面还需要显示用户名与商品名称。前端必须先查订单,再根据两个 ID 查询用户与商品,最后把三份结果拼起来。
查询订单 → 获得 userId、productId → 查询用户和商品 → 组装页面数据
这个过程会让前端承担几类额外工作:
- 安排请求顺序:用户和商品查询依赖订单里的 ID,不能在订单返回前直接发起。
- 处理部分失败:订单查到了,商品接口却报错,页面需要决定显示错误、重试还是隐藏部分内容。
- 适配不同接口:三个接口的字段名称、数据层级和错误格式可能不同,前端需要分别转换。
- 重复维护组合逻辑:Web 页面和移动端都需要订单信息时,可能各写一遍相同的查询与拼接代码。
多个请求本身并不意味着设计有问题。如果接口数量少、返回数据正好满足页面,直接调用很合理。当这种组合逻辑在多个页面或客户端反复出现时,才值得考虑集中处理。
🧱 BFF 是什么,与普通业务后端有什么区别
BFF 是 Backend for Frontend,意思是面向前端的后端。它根据页面需要组织接口。普通订单服务回答“订单是什么”,BFF 回答“订单详情页需要展示什么”。两者都可以用 Express 编写,差别在于职责,而不是使用的框架。
BFF 是前端开发,还是后端开发?
BFF 是运行在服务端的程序,但不一定由后端工程师编写。 前端工程师如果掌握 Node.js 和 Express,也可以开发 BFF。这里需要区分两件事:代码由谁负责,与代码运行在哪里。
| 对比 | 前端页面 | BFF | 业务后端 |
|---|---|---|---|
| 运行位置 | 通常在浏览器或 App 中 | 服务端 | 服务端 |
| 主要职责 | 页面展示、用户交互 | 按页面需要调用和整理业务接口 | 执行业务规则、读写业务数据 |
| 常见开发人员 | 前端工程师 | 前端、后端或全栈工程师 | 后端工程师 |
例如,订单详情页需要显示用户名和商品名称:
- 前端工程师负责 BFF 时:可以用 Node.js 编写
/bff/orders/:id,请求订单、用户和商品接口,再返回适合页面的数据。前端团队能够自行调整页面所需字段,不必每次都要求业务后端新增专用接口。 - 后端工程师负责 BFF 时:实现的仍然是同一个接口和同一套数据聚合逻辑,只是由后端团队维护服务部署、调用和错误处理等工作。
因此,两种做法的技术职责没有本质区别,主要区别是团队分工和维护责任。无论谁开发,BFF 都不能因为“面向前端”就放到浏览器中运行,也不应自行决定订单计价、库存扣减等核心业务规则。这些规则仍由业务服务统一负责。
🛠 BFF 如何为不同前端提供合适的数据
没有 BFF 时,浏览器先取订单,根据其中的 userId 与 productId 再分别查询用户和商品。浏览器需要知道三个接口的字段和错误格式。增加 BFF 后,浏览器只需请求 /bff/orders/o1,其中 o1 是要查询的订单 ID。
BFF 位于前端与业务服务之间,收到请求后按以下顺序处理:
- 向订单服务查询订单
o1,取得订单金额、用户 ID 和商品 ID。 - 根据两个 ID 分别查询用户与商品。这两次查询互不依赖,可以同时发起。
- 从查询结果中取出页面需要的字段,组合成一份响应返回浏览器。
原来由浏览器承担的请求编排和数据拼接,现在由 BFF 负责。浏览器收到的结果如下:
{
"id": "o1",
"customerName": "小林",
"productName": "机械键盘",
"totalCents": 59800
}
totalCents 用整数“分”表示金额。BFF 不重新计算订单价格,因为商品现在的价格可能与下单时不同。它使用订单服务保存的金额,再由前端格式化为 598.00 元。
不同前端不一定需要同一份响应。移动端订单卡片可以只返回上面的四个字段;桌面端详情页还可以增加购买数量和用户链接。BFF 从同一组业务接口获取数据,再按页面约定筛选字段,避免每个客户端重复整理整套数据。
BFF 的核心职责是满足前端的使用需要,接口聚合只是其中一种手段。 即使只调用一个业务接口,也可能需要为页面调整字段名称或数据结构。需求接近的前端可以共用 BFF;需求差异较大时,可以分别维护面向各自前端的 BFF。是否拆分取决于适配需求和维护成本,而不是要求所有前端统一使用同一套响应。
一次前端请求仍然可能触发三次内部请求。BFF 减少的是浏览器需要编排的调用,不会凭空消除服务之间的工作量,也不保证一定更快。
💡 什么时候适合使用 BFF,什么时候没有必要
| 项目情况 | 可以如何选择 |
|---|---|
| 一个页面、一个业务接口,响应已符合需要 | 直接调用,先保持简单 |
| 多个页面反复组合相同的后端数据 | 将页面组合逻辑放入 BFF |
| 桌面端要完整详情,移动端只需摘要 | 由 BFF 提供不同的展示结构 |
| 下单价格、库存扣减规则复杂 | 放在业务服务,BFF 不接管规则 |
独立部署 BFF 需要额外维护和运行一个服务,也增加一个可能失败的环节。小团队可以先在一个应用里划分页面适配模块和业务模块,等到发布节奏或负载确实不同,再拆成独立进程。
❓ 知识问答
Q1:有 BFF 就是微服务架构吗?
不是。BFF 可以调用一个单体后端,也可以调用多个服务。面向页面的接口组织方式,与业务后端是否拆分是两件事。
Q2:所有前端都必须拥有独立 BFF 吗?
不必。只有响应结构、发布节奏或维护团队的差异值得承担额外成本时,才考虑分开。
🧪 小练习
沿用本文的订单页面,判断以下操作分别应由前端、BFF 还是业务服务负责,并写出理由:
- 调用用户接口取得用户名,将它拼接到订单页面的响应中。
- 根据优惠规则计算下单时的应付金额,并保存到订单中。
- 将响应中的
totalCents: 59800格式化为页面上的598.00元。
参考答案:
- 第 1 项由 BFF 负责。这是在组合页面需要的数据;用户信息本身仍由用户服务提供。
- 第 2 项由业务服务负责。优惠规则决定订单实际收取多少钱,需要由负责订单计价的业务逻辑统一执行,不能由不同页面的适配逻辑自行决定。
- 第 3 项在本文方案中由前端负责。这是展示格式的转换,不改变订单保存的金额。
自查时,应能解释:同一个金额既是业务计算结果,也是页面展示内容,因此要根据“对数据执行什么操作”划分职责,不能仅凭字段是否显示在页面上来判断。
🎉 判断项目是否需要 BFF,理解页面适配与业务服务的职责边界!
