Express Node.js应用本地开发使用模拟数据的最佳实践咨询

针对你提到的两种方案，先分析各自的优缺点：

现有方案的问题 #

方案1：环境变量+if/else判断 #

• 优势：无需额外启动服务，通过环境变量即可快速切换数据源
• 劣势：每个接口都要重复编写判断逻辑，接口越多代码冗余越严重，真实业务逻辑与模拟逻辑耦合在一起，后期维护成本高

方案2：单独维护Mock Express服务 #

• 优势：真实逻辑与模拟逻辑完全分离，代码干净，可独立测试Mock数据
• 劣势：需要维护两套Express应用，本地开发要启动两个服务，接口路径需手动同步，容易出现不一致，配置复杂度高

更优的替代方案 #

1. 封装数据服务层，解耦数据源 #

把第三方API调用逻辑抽成独立模块，根据环境变量切换真实/模拟实现：

真实数据服务（services/dataService.js）

const axios = require('axios');

exports.fetchData = async () => {
  const response = await axios.get('https://someapi.com/do/1');
  return response.data;
};

模拟数据服务（services/mockDataService.js）

exports.fetchData = async () => {
  return {
    id: 1,
    content: '模拟返回的数据'
  };
};

路由中使用

// 根据环境变量选择服务
const dataService = process.env.USE_MOCK === 'true' 
  ? require('./services/mockDataService') 
  : require('./services/dataService');

app.get('/api/data', async (req, res) => {
  try {
    const data = await dataService.fetchData();
    res.json(data);
  } catch (error) {
    res.status(500).json({ error: 'Failed to fetch data' });
  }
});

这种方式让路由逻辑保持干净，仅需维护不同的服务实现，后期新增接口也只需添加对应服务方法即可。

2. 使用Mock中间件拦截请求 #

编写Express中间件，根据环境变量拦截指定接口并返回模拟数据，无需修改原有路由代码：

Mock中间件（middleware/mockMiddleware.js）

// 维护接口与模拟数据的映射
const mockDataMap = {
  '/api/data': { id: 1, content: '模拟数据' },
  '/api/other': { list: [1,2,3] }
};

module.exports = (req, res, next) => {
  if (process.env.USE_MOCK === 'true' && mockDataMap[req.path]) {
    return res.json(mockDataMap[req.path]);
  }
  // 不匹配则走真实逻辑
  next();
};

应用中间件

// 仅在本地开发环境加载Mock中间件
if (process.env.USE_MOCK === 'true') {
  app.use(require('./middleware/mockMiddleware'));
}

// 原有真实路由
app.get('/api/data', async (req, res) => {
  const response = await axios.get('https://someapi.com/do/1');
  res.json(response.data);
});

这种方案适合接口较多的场景，只需维护映射表即可，对原有代码侵入极低。

3. 使用Nock拦截HTTP请求（零侵入） #

使用nock库直接拦截axios发出的第三方API请求，完全不需要修改业务代码：

本地开发入口文件配置

if (process.env.USE_MOCK === 'true') {
  const nock = require('nock');
  
  // 拦截指定域名的请求，返回模拟数据
  nock('https://someapi.com')
    .get('/do/1')
    .reply(200, { id: 1, content: '模拟数据' });
  
  // 还可以模拟错误场景
  nock('https://someapi.com')
    .get('/do/error')
    .reply(500, { error: '模拟服务异常' });
}

这种方式的优势是零业务代码侵入，原有接口逻辑完全不需要改动，还能灵活模拟各种响应状态（成功、错误、超时等），非常适合测试异常处理逻辑。

方案推荐 #

• 接口数量少、逻辑简单：选择封装数据服务层的方式，逻辑清晰易维护
• 接口多、希望快速切换：优先选择Nock拦截或Mock中间件，尤其是Nock，零侵入成本最低
• 不推荐单独维护Mock服务，除非需要跨项目共享Mock接口，否则维护成本远高于其他方案

内容的提问来源于stack exchange，提问作者Feather Ridgemont