2. BFF层核心职责：数据聚合、接口适配、鉴权转发、降级熔断、前端专属逻辑编排

BFF（Backend For Frontend）层位于前端与后端微服务之间，其核心职责可归纳为五大能力域。理解这些职责是设计接口契约与测试策略的前提。

2.1 五大核心职责概览

2.2 数据聚合与接口适配

数据聚合是 BFF 最直观的职责。前端一个页面请求，BFF 可能并发调用 3~5 个下游服务，然后合并结果。接口适配则负责消除前后端之间的格式差异。

// 示例：BFF 聚合用户信息与订单列表
// 下游响应
// GET /user-service/users/123 → { id: 123, name: "张三", email: "zhang@example.com" }
// GET /order-service/users/123/orders → [{ orderId: "O001", total: 99.9 }]

// BFF 聚合后响应给前端
{
  "userId": 123,
  "userName": "张三",
  "email": "zhang@example.com",
  "recentOrders": [
    { "orderId": "O001", "amount": 99.9 }
  ]
}

2.3 鉴权转发与降级熔断

鉴权转发是 BFF 的安全屏障。BFF 统一解析前端携带的 Token，校验身份与权限，再将用户身份信息（如 userId、角色）透传给下游。降级熔断则是 BFF 的容错机制，当依赖服务不可用时，BFF 应返回预设的降级数据而非直接报错。

// 鉴权转发流程（伪代码）
function handleRequest(req) {
  const token = req.headers['authorization'];
  const user = authService.verifyToken(token);  // 鉴权
  if (!user) {
    return { status: 401, body: { code: "AUTH_FAILED", message: "无效令牌" } };
  }
  // 转发时携带用户身份
  const orders = orderService.getOrders(user.userId, { headers: { 'x-user-id': user.userId } });
  return { status: 200, body: orders };
}

2.4 前端专属逻辑编排

BFF 可以承载前端特有的业务编排，例如根据用户角色展示不同的页面模块、计算页面级状态、合并多个来源的数据并排序。这部分逻辑是 BFF 区别于通用 API Gateway 的关键。

// 前端专属编排示例：根据用户等级展示不同权益
function composeDashboard(user) {
  const baseInfo = userService.getBaseInfo(user.id);
  let privileges = [];
  if (user.level === 'vip') {
    privileges = ['免广告', '高清画质', '专属客服'];
  } else {
    privileges = ['基础功能'];
  }
  return { ...baseInfo, privileges, level: user.level };
}

2.5 核心职责与契约测试的映射关系

下图展示了 BFF 五大职责在请求处理链路中的位置，以及每个职责对应的契约测试切入点。

2.6 职责间的依赖关系

五大职责并非独立运行，它们之间存在明确的依赖与触发顺序。理解这些关系有助于设计更精准的契约测试用例。

• 鉴权转发 → 所有后续职责：鉴权失败时，后续的数据聚合、编排等职责不应执行。
• 数据聚合 → 接口适配：聚合后的数据通常需要经过适配转换才能返回给前端。
• 降级熔断 → 数据聚合：当某个下游服务降级时，聚合逻辑需要处理降级数据。
• 前端专属编排 → 最终响应：编排逻辑在聚合与适配之后执行，决定最终返回结构。