NestJS嵌套模块Mock失败：测试时仍调用SMTP服务器求解决

问题根源 #

你的Mock失效核心原因是NestJS模块提供者的优先级规则：模块内部注册的提供者 > 全局模块提供者。由于UtilsModule导入并导出了EmailModule，而EmailModule已经注册了真实的Emailer实现（EmailService），你在全局TestModule中配置的Mock提供者无法穿透嵌套模块覆盖已存在的同token提供者。此外，如果EmailModule直接使用MailerModule.forRoot配置了真实SMTP参数，即使Mock了EmailService，MailerModule初始化阶段可能仍会尝试建立SMTP连接。

具体解决方法 #

1. 针对抽象类Emailer直接Override提供者 #

因为你的EmailModule中是通过{ provide: Emailer, useClass: EmailService }注册的服务，测试时需要直接覆盖Emailer这个注入token，而非EmailService类本身：

const moduleFixture = await Test.createTestingModule({
  imports: [AppModule],
})
// 覆盖整个模块树中的Emailer提供者
.overrideProvider(Emailer)
.useValue({
  sendEmail: jest.fn().mockResolvedValue(true), // 模拟sendEmail方法
})
.compile();

const app = moduleFixture.createNestApplication();
await app.init();

2. 禁用MailerModule的真实SMTP连接 #

如果EmailModule中直接硬编码了MailerModule.forRoot(真实配置)，即使Mock了EmailService，MailerModule可能仍会初始化SMTP连接。此时需要同时OverrideMailerModule，使用nodemailer的模拟配置：

const moduleFixture = await Test.createTestingModule({
  imports: [AppModule],
})
.overrideProvider(Emailer)
.useValue({
  sendEmail: jest.fn().mockResolvedValue(true),
})
// 替换MailerModule为模拟配置
.overrideModule(MailerModule)
.useModule(MailerModule.forRoot({
  transport: {
    jsonTransport: true, // 仅输出邮件内容到控制台，不发真实邮件
  },
}))
.compile();

3. 简化测试模块，避免加载完整AppModule #

如果测试只涉及依赖Emailer的部分功能，可以直接导入UtilsModule并Override，无需加载整个AppModule，减少嵌套模块的干扰：

const moduleFixture = await Test.createTestingModule({
  imports: [UtilsModule],
})
.overrideProvider(Emailer)
.useValue({
  sendEmail: jest.fn().mockResolvedValue(true),
})
.compile();

常见排查点 #

• 确认你Mock的是抽象类Emailer而非EmailService：模块中注入的是Emailer，所以必须针对这个token做替换。
• 检查测试代码是否正确调用了Test.createTestingModule并完成override操作，避免直接实例化真实模块。
• 若EmailService是通过useFactory创建的，确保override的是Emailer的提供者，而非工厂函数本身。

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