Node.js运行Jest测试报TypeError: logWarnFn is not a function错误

Node.js服务端运行Jest测试用例时抛出如下错误，错误触发点为调用i18n翻译方法的位置：

TypeError: logWarnFn is not a function

      18 |     });
      19 |     if (!user) {
    > 20 |       throw new createHttpError.BadRequest(i18n.__("user_not_exist"));
         |                                                 ^
      21 |     }

项目中使用i18n模块实现多语言翻译，Jest运行时无法正常加载识别该模块。

这个报错本质是i18n模块在Jest测试环境中未完成正确初始化：
正常启动Node服务时，一般会在入口文件调用i18n.configure()注入翻译目录、日志方法、默认语言等配置，但Jest执行单测时默认不会加载完整的服务启动流程，直接引入业务模块调用时，i18n处于未配置状态，内部触发警告逻辑时找不到对应的logWarnFn实现，就会抛出类型错误。

• 核对测试执行流程：确认测试用例运行前，是否执行了项目里的i18n初始化配置代码，有没有出现业务代码先调用i18n.__()、初始化逻辑后执行的顺序问题。
• 检查i18n配置项：确认i18n.configure()里有没有显式配置logWarnFn、logErrorFn等日志回调，部分老版本i18n不会默认兜底这几个方法，未传值时内部直接调用就会报错。
• 排查Jest模块Mock规则：检查项目里的Jest配置、__mocks__目录下有没有手动Mock i18n模块，且Mock实现缺失内部依赖的方法。

• 全局初始化i18n适配测试环境
  在Jest配置文件中添加setup文件，在所有测试用例执行前统一完成i18n初始化，配置示例：
  首先修改jest.config.js：

  module.exports = {
    // 其他原有配置...
    setupFilesAfterEnv: ['./jest.setup.js']
  }
  

  然后在项目根目录新建jest.setup.js，写入初始化逻辑：

  const i18n = require('i18n');
  const path = require('path');
  
  i18n.configure({
    locales: ['zh-CN', 'en-US'], // 替换为项目实际支持的语言列表
    directory: path.join(__dirname, 'locales'), // 替换为项目实际存放翻译文件的目录
    defaultLocale: 'zh-CN',
    // 显式传入日志方法，从根源避免logWarnFn不存在的问题
    logWarnFn: console.warn,
    logErrorFn: console.error
  });
  
  // 如果业务代码是直接调用全局挂载的__方法，在这里同步挂载
  global.__ = i18n.__;
  

• 单测内手动Mock i18n
  如果单测不需要验证实际翻译逻辑，可以直接在测试文件顶部Mock i18n，跳过真实的i18n执行流程：

  jest.mock('i18n', () => ({
    __: (str) => str, // 直接返回翻译key，满足业务代码调用需求即可
    configure: jest.fn()
  }));
  

• 统一i18n引入方式
  把项目里的i18n初始化逻辑封装成单独的模块，所有业务代码都引入初始化完成后的i18n实例，避免直接从npm包引入未初始化的i18n对象：

  // utils/i18n.js  封装初始化后的i18n实例
  const i18n = require('i18n');
  const path = require('path');
  
  i18n.configure({
    locales: ['zh-CN', 'en-US'],
    directory: path.join(__dirname, '../locales'),
    defaultLocale: 'zh-CN',
    logWarnFn: console.warn,
    logErrorFn: console.error
  });
  
  module.exports = i18n;
  

  业务代码和测试文件里统一从这个封装模块引入i18n即可。

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