Mocha测试间模块重新导入问题：Node/TypeScript Express配置异常

这个问题我之前帮不少开发者解决过——核心原因就是Node.js模块系统的缓存机制在搞鬼！

问题根源 #

你当前的config.ts直接导出了Config.get()的执行结果，也就是加载settings.json后得到的对象。Node.js的模块加载规则是：当某个模块第一次被导入时，会执行其代码并缓存导出的结果，后续所有对该模块的import都会直接复用缓存的对象，不会重新执行模块内的代码。

这就导致在Mocha测试中：

• 如果你想在不同测试用例中使用不同的配置，无法重新加载settings.json
• 即使你修改了settings.json文件，测试也不会读取到新的内容
• 多个测试用例共享同一个配置对象，容易造成测试污染

解决方案 #

下面提供几种实用的解决思路，你可以根据自己的测试需求选择：

1. 修改配置模块，延迟加载配置

不要直接导出配置对象，而是导出一个函数或类方法，每次调用时才加载配置（可选清除缓存）：

// config.ts
import * as path from 'path';

export function getConfig() {
  // 清除settings.json的模块缓存，确保每次调用都读取最新文件
  const settingsPath = path.resolve(__dirname, './settings.json');
  delete require.cache[settingsPath];
  
  return require(settingsPath);
}

// 或者保留类的写法，但不要直接导出结果
class Config {
  public static get() {
    const settingsPath = path.resolve(__dirname, './settings.json');
    delete require.cache[settingsPath];
    return require(settingsPath);
  }
}
export default Config;

使用时改为：

import { getConfig } from './config';
// 或者 import Config from './config';
const config = getConfig(); // 或者 Config.get();

这样每次调用getConfig()都会重新读取settings.json，测试中可以灵活控制配置加载时机。

2. 在测试中Mock配置对象

如果不需要读取真实的settings.json，而是想直接使用自定义的测试配置，可以用proxyquire这类工具替换模块依赖：

// 测试文件
const proxyquire = require('proxyquire');

describe('测试示例', () => {
  it('使用Mock配置执行测试', () => {
    // 定义测试用的Mock配置
    const mockedConfig = {
      apiPort: 3001,
      apiUrl: 'http://test.local'
    };

    // 用proxyquire加载目标模块，替换其对config的依赖
    const MyService = proxyquire('../src/my-service', {
      './config': mockedConfig
    });

    // 执行测试断言
    expect(MyService.getApiUrl()).toBe('http://test.local');
  });
});

3. 动态修改配置对象（适用于简单场景）

因为导出的配置是一个引用类型的对象，你可以直接修改其属性，但要注意在每个测试前后重置配置，避免测试污染：

// 测试文件
import Config from './config';
import originalSettings from './settings.json';

beforeEach(() => {
  // 在每个测试前重置配置为原始状态
  Object.assign(Config, originalSettings);
});

it('修改配置属性进行测试', () => {
  // 修改配置
  Config.apiPort = 3001;
  
  // 执行测试逻辑
  // ...
});

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