4. BFF单元测试：业务逻辑、Mock外部依赖与Jest/Mocha实践

BFF（Backend For Frontend）层的核心职责是聚合、裁剪和编排下游微服务数据。单元测试的目标是隔离验证BFF自身的业务逻辑，确保路由处理、数据转换、错误处理等代码的正确性，同时通过Mock技术切断对外部服务（如下游API、数据库、缓存）的依赖。

4.1 BFF单元测试的边界与策略

BFF单元测试不关注下游服务的正确性，只关注BFF层内部逻辑。测试策略应遵循以下原则：

4.2 Mock外部依赖：隔离BFF核心逻辑

Mock的核心目标是消除不确定性。BFF中常见的外部依赖包括：

• 下游HTTP/RPC服务：使用nock、sinon或jest.mock拦截请求。
• 缓存（Redis/Memcached）：Mock缓存客户端，返回预设数据。
• 配置中心：直接注入测试配置对象。
• 日志与监控：Mock日志收集器，验证调用次数而非内容。

4.3 使用Jest进行BFF单元测试

Jest是当前最流行的JavaScript测试框架，内置断言、Mock和覆盖率工具。以下是一个典型的BFF聚合函数测试示例：

// userAggregator.js — BFF聚合逻辑
const { fetchUserProfile, fetchUserOrders } = require('./downstreamClients');

async function getUserDashboard(userId) {
  const [profile, orders] = await Promise.all([
    fetchUserProfile(userId),
    fetchUserOrders(userId)
  ]);
  return {
    id: profile.id,
    name: profile.name,
    recentOrders: orders.slice(0, 5).map(o => ({
      orderId: o.id,
      total: o.amount
    }))
  };
}

module.exports = { getUserDashboard };

// userAggregator.test.js — Jest单元测试
const { getUserDashboard } = require('./userAggregator');
const downstreamClients = require('./downstreamClients');

jest.mock('./downstreamClients');

describe('getUserDashboard', () => {
  beforeEach(() => {
    jest.clearAllMocks();
  });

  test('应正确聚合用户资料和最近5笔订单', async () => {
    downstreamClients.fetchUserProfile.mockResolvedValue({
      id: 'u001', name: '张三'
    });
    downstreamClients.fetchUserOrders.mockResolvedValue([
      { id: 'ord1', amount: 100 },
      { id: 'ord2', amount: 200 },
      { id: 'ord3', amount: 150 },
      { id: 'ord4', amount: 300 },
      { id: 'ord5', amount: 50 },
      { id: 'ord6', amount: 400 }  // 第6笔应被截断
    ]);

    const result = await getUserDashboard('u001');

    expect(result).toEqual({
      id: 'u001',
      name: '张三',
      recentOrders: [
        { orderId: 'ord1', total: 100 },
        { orderId: 'ord2', total: 200 },
        { orderId: 'ord3', total: 150 },
        { orderId: 'ord4', total: 300 },
        { orderId: 'ord5', total: 50 }
      ]
    });
    expect(downstreamClients.fetchUserProfile).toHaveBeenCalledWith('u001');
    expect(downstreamClients.fetchUserOrders).toHaveBeenCalledWith('u001');
  });

  test('当下游服务超时时应抛出友好错误', async () => {
    downstreamClients.fetchUserProfile.mockRejectedValue(
      new Error('Service timeout')
    );
    downstreamClients.fetchUserOrders.mockResolvedValue([]);

    await expect(getUserDashboard('u002')).rejects.toThrow('用户服务暂时不可用');
  });
});

4.4 使用Mocha + Sinon进行BFF单元测试

Mocha提供灵活的测试结构，配合Sinon实现Mock和Spy。适用于需要精细控制Mock行为的场景：

// userAggregator.mocha.test.js — Mocha + Sinon测试
const sinon = require('sinon');
const { expect } = require('chai');
const { getUserDashboard } = require('./userAggregator');
const downstreamClients = require('./downstreamClients');

describe('getUserDashboard (Mocha)', () => {
  let profileStub, ordersStub;

  beforeEach(() => {
    profileStub = sinon.stub(downstreamClients, 'fetchUserProfile');
    ordersStub = sinon.stub(downstreamClients, 'fetchUserOrders');
  });

  afterEach(() => {
    profileStub.restore();
    ordersStub.restore();
  });

  it('应返回聚合后的用户仪表盘数据', async () => {
    profileStub.resolves({ id: 'u003', name: '李四' });
    ordersStub.resolves([{ id: 'ord7', amount: 500 }]);

    const result = await getUserDashboard('u003');

    expect(result).to.have.property('name', '李四');
    expect(result.recentOrders).to.have.lengthOf(1);
    expect(profileStub.calledOnceWith('u003')).to.be.true;
  });

  it('当订单列表为空时应返回空数组', async () => {
    profileStub.resolves({ id: 'u004', name: '王五' });
    ordersStub.resolves([]);

    const result = await getUserDashboard('u004');

    expect(result.recentOrders).to.be.an('array').that.is.empty;
  });
});

4.5 BFF单元测试的SVG架构图

下图展示了BFF单元测试中，测试框架、Mock层与BFF业务逻辑之间的交互关系：

4.6 测试覆盖率与质量门禁

BFF单元测试应设定明确的覆盖率目标，并集成到CI流水线中：

npx jest --coverage --coverageThreshold='{"global":{"branches":80,"functions":90,"lines":85}}'

4.7 最佳实践与避坑指南

• 每个测试只验证一个行为：避免在一个test块中同时验证正常路径和异常路径。
• 使用beforeEach重置Mock：防止测试用例间状态污染，Jest使用jest.clearAllMocks()，Mocha使用sinon.restore()。
• Mock返回值要贴近真实数据结构：避免使用{}或null，应构造与下游服务一致的字段结构。
• 测试异步错误路径：使用mockRejectedValue模拟网络超时、500错误、空响应等场景。
• 不要Mock你未拥有的代码：只MockBFF直接调用的依赖模块，不要Mock第三方库内部实现。