1.1 BFF 模式概述

1.1.1 BFF 概念

BFF（Backend For Frontend，服务于前端的后端） 是一种由 SoundCloud 提出的微服务架构模式。其核心思想是：为每一种前端客户端（Web、iOS、Android、小程序等）单独构建一个专属的后端服务，该服务负责聚合下游微服务的数据、适配前端特定的交互逻辑，并输出恰好满足该客户端需求的数据结构。

BFF 不是简单的 API 代理，而是一个有业务逻辑的中间层。它解决了传统微服务架构中“一个后端 API 试图适配所有前端”导致的接口臃肿、字段冗余、多次请求等问题。

1.1.2 BFF 在微服务中的角色

在微服务架构中，BFF 处于客户端与下游微服务之间，扮演着以下关键角色：

• 聚合器（Aggregator）：将多个微服务的响应合并为一个响应，减少客户端请求次数。
• 适配器（Adapter）：将后端通用数据模型转换为前端特定视图模型（ViewModel）。
• 编排器（Orchestrator）：根据前端业务流程，编排多个微服务的调用顺序。
• 安全网关（Security Gateway）：集中处理身份认证、权限校验、会话管理。
• 协议转换器（Protocol Translator）：将后端 gRPC/Thrift 协议转换为前端友好的 HTTP/REST 或 GraphQL。

下图展示了 BFF 在微服务架构中的典型位置与交互关系：

1.1.3 BFF 与 API Gateway 的区别

很多开发者容易将 BFF 与 API Gateway 混淆。虽然两者都位于客户端与后端之间，但它们的职责边界、粒度、业务参与度有本质区别。下表从多个维度进行对比：

下图直观展示了 API Gateway 与 BFF 在架构中的不同位置与职责边界：

1.1.4 为什么 BFF 需要独立的权限验证

在 BFF 模式中，权限验证不再是简单的“透传 Token 到后端”。BFF 需要根据前端客户端的类型（Web、Mobile、小程序）执行差异化的权限策略：

• Web 端：通常使用 Cookie + Session 或 OAuth2 Authorization Code 流程。
• 移动端：使用 JWT + Refresh Token，支持离线 Token 刷新。
• 小程序端：依赖平台登录态（ code 换取 session_key）。

BFF 作为权限校验的第一道防线，需要完成以下工作：

1. Token 解析与验证：从请求头、Cookie 或 Query 参数中提取 Token，验证签名和有效期。
2. 上下文注入：将解析后的用户身份、角色、权限范围注入到请求上下文。
3. 细粒度权限校验：根据 API 路径、HTTP 方法、资源 ID 判断当前用户是否有操作权限。
4. 错误响应：权限不足时返回 401/403，并携带清晰的错误码。