如何在Express.js中为Axios调用的外部API配置可选Mock代理

完全可以通过Axios的配置来简化这类需求，无需依赖http-proxy-middleware做服务器端代理，直接在Axios层面就能实现环境切换+配合Mock服务器自动录制响应的效果，具体实现如下：

1. 通过环境变量一键切换API目标服务器 #

核心思路是给Axios实例配置动态的baseURL，用环境变量控制真实API和Mock服务器的切换，所有基于该实例的请求都会自动适配目标地址。

示例代码：

const axios = require('axios');

// 从环境变量读取目标配置，默认用真实服务器
const apiBaseUrl = process.env.USE_MOCK === 'true'
  ? 'https://mockserver/foo/api/'
  : 'https://realserver/foo/api/';

// 创建全局复用的Axios实例
const apiClient = axios.create({
  baseURL: apiBaseUrl,
  // 其他全局配置（超时、请求头等）
  timeout: 10000
});

之后Express服务器里所有调用外部API的逻辑，都用这个apiClient发起请求即可，比如：

// 示例：调用外部API接口
app.get('/user', async (req, res) => {
  try {
    const response = await apiClient.get('/user/profile', { params: req.query });
    res.json(response.data);
  } catch (err) {
    res.status(500).json({ error: err.message });
  }
});

启动服务时通过环境变量切换：

# 用真实API启动
node server.js

# 切换到Mock服务器启动
USE_MOCK=true node server.js

2. 让Mock服务器自动录制/回放真实响应 #

你需要的「自动存储真实API响应、无需手动维护Mock数据」的需求，不需要在Express或Axios里写额外逻辑，直接用支持录制模式的Mock服务器即可，比如WireMock、Mockoon这类工具：

• 开启Mock服务器的「录制模式」，并配置它的转发目标为真实API服务器（https://realserver/foo/api/）
• 当Axios请求Mock服务器时，Mock服务器会自动把请求转发到真实API，同时将响应内容存储到本地
• 后续切换到「回放模式」，Mock服务器就会直接返回之前存储的响应，不再调用真实API

这种方式下，Axios只需要负责切换baseURL，Mock服务器自己处理转发和存储逻辑，完全不需要你手动维护两端的路径映射。

3. 进阶：路径差异的统一处理 #

如果真实API和Mock服务器的路径前缀不一致（比如真实路径是/foo/api/v1，Mock路径是/api/v1），可以用Axios请求拦截器统一修改路径：

apiClient.interceptors.request.use((config) => {
  if (process.env.USE_MOCK === 'true') {
    // 替换路径前缀，适配Mock服务器的路径规则
    config.url = config.url.replace('/foo/api/', '/api/');
  }
  return config;
});

总结 #

这种方案比你提到的「两端点映射」更简洁：

• 所有切换逻辑集中在Axios配置层，无需修改Express的路由或代理配置
• 配合支持录制的Mock服务器，完全省去手动维护Mock数据的工作量
• 环境切换仅需一个环境变量，测试和生产环境的代码逻辑完全一致

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