3. BFF聚合服务测试策略总览：测试金字塔在BFF中的适配、分层测试策略、测试环境搭建

BFF（Backend For Frontend）聚合服务处于前端与后端微服务之间的“胶水层”，其测试策略不能简单照搬传统后端测试金字塔。本章从测试金字塔适配、分层策略、环境搭建三个维度，构建一套专为BFF设计的可落地测试体系。

3.1 测试金字塔在BFF中的适配

传统测试金字塔强调“底层单元测试多、上层端到端测试少”。BFF引入后，金字塔结构需要调整：契约测试和聚合层集成测试成为新的重心。

3.2 分层测试策略详解

BFF分层测试策略覆盖五个层级，每层有明确的测试目标、工具选型和通过标准。

3.3 分层测试策略实施要点

3.3.1 契约测试：BFF测试的核心差异点

BFF作为消费者，依赖多个下游微服务。契约测试确保下游接口变更不会破坏BFF。

// 契约测试示例（Pact + Jest）
const { PactV3, MatchersV3 } = require('@pact-foundation/pact');
const { like, eachLike } = MatchersV3;

describe('BFF 与 用户服务 的契约', () => {
  const provider = new PactV3({
    consumer: 'bff-user-api',
    provider: 'user-service',
  });

  it('应返回用户基本信息', async () => {
    provider
      .given('用户存在')
      .uponReceiving('获取用户信息请求')
      .withRequest({
        method: 'GET',
        path: '/api/v1/users/123',
        headers: { Accept: 'application/json' },
      })
      .willRespondWith({
        status: 200,
        headers: { 'Content-Type': 'application/json' },
        body: {
          id: like('123'),
          name: like('张三'),
          email: like('zhangsan@example.com'),
        },
      });

    await provider.executeTest(async (mockServer) => {
      const response = await fetch(`${mockServer.url}/api/v1/users/123`);
      expect(response.status).toBe(200);
    });
  });
});

3.3.2 BFF聚合集成测试：模拟下游，验证聚合

使用Mock Server模拟下游微服务，重点验证BFF的聚合逻辑、数据合并、超时和降级处理。

// BFF 聚合集成测试示例（Jest + Supertest）
const request = require('supertest');
const app = require('../app');
const nock = require('nock');

describe('BFF 聚合接口 /api/dashboard', () => {
  beforeEach(() => {
    // 模拟用户服务
    nock('http://user-service')
      .get('/users/1')
      .reply(200, { id: '1', name: '张三' });

    // 模拟订单服务
    nock('http://order-service')
      .get('/orders?userId=1')
      .reply(200, [
        { orderId: '1001', amount: 299 },
        { orderId: '1002', amount: 159 },
      ]);
  });

  it('应正确聚合用户信息和订单列表', async () => {
    const res = await request(app)
      .get('/api/dashboard?userId=1')
      .expect(200);

    expect(res.body.user.name).toBe('张三');
    expect(res.body.orders).toHaveLength(2);
    expect(res.body.totalAmount).toBe(458);
  });

  it('当下游服务超时时应返回降级数据', async () => {
    nock('http://order-service')
      .get('/orders?userId=1')
      .delay(5000) // 超时
      .reply(200, []);

    const res = await request(app)
      .get('/api/dashboard?userId=1')
      .expect(200);

    expect(res.body.orders).toEqual([]);
    expect(res.body.degraded).toBe(true);
  });
});

3.4 测试环境搭建

BFF测试环境需要兼顾“轻量快速”和“贴近真实”。推荐采用分层环境策略：

• 本地开发环境： Docker Compose 启动 BFF + Mock Server（WireMock / MockServer），不依赖真实下游。
• CI 环境： 使用 Pact Broker 管理契约，CI Pipeline 中并行运行单元测试 + 契约测试 + 聚合集成测试。
• 预发布环境： 连接真实下游测试环境（Staging），运行 E2E 测试和性能基准测试。

3.5 测试环境关键配置清单

3.6 测试策略决策矩阵

根据BFF的不同变更类型，选择对应的测试层级：