NestJS Jest单元测试因参数装饰器崩溃，如何解决？

问题根源 #

• Jest默认Babel配置未启用参数装饰器支持，导致GraphQL @Args这类参数装饰器触发语法错误
• 单独启用babel-plugin-parameter-decorator会破坏NestJS/TypeORM对类装饰器（如@Prop）和类.name属性的解析逻辑，引发类型识别失败和无信息TypeError

可行解决方案 #

1. 使用NestJS官方测试工具链（优先推荐） #

NestJS的@nestjs/testing已经内置了装饰器适配逻辑，无需额外配置Babel：

• 所有测试都通过Test.createTestingModule构建测试模块，不要直接导入服务类实例
• 示例测试代码：

import { Test } from '@nestjs/testing';
import { MyService } from './my.service';
import { getModelToken } from '@nestjs/mongoose';

describe('MyService', () => {
  let service: MyService;

  beforeEach(async () => {
    const moduleRef = await Test.createTestingModule({
      providers: [
        MyService,
        {
          provide: getModelToken(MyModel), // 直接传入类而非.name属性
          useValue: {
            // 按需模拟Model的方法
            findById: jest.fn().mockResolvedValue({}),
          },
        },
      ],
    }).compile();

    service = moduleRef.get<MyService>(MyService);
  });

  it('should initialize correctly', () => {
    expect(service).toBeDefined();
  });
});

2. 调整Babel配置兼容装饰器 #

如果必须自定义Babel配置，放弃单独使用babel-plugin-parameter-decorator，改用@babel/plugin-proposal-decorators并保证正确的插件顺序：

• 修改babel.config.js：

module.exports = {
  presets: [
    ['@babel/preset-env', { targets: { node: 'current' } }],
    '@babel/preset-typescript',
  ],
  plugins: [
    ['@babel/plugin-proposal-decorators', { legacy: true }],
    ['@babel/plugin-proposal-class-properties', { loose: true }],
  ],
};

• 关键要点：decorators插件必须放在class-properties之前，且开启legacy: true，这样既支持参数装饰器，又不会破坏原有类装饰器和属性的解析逻辑

3. 修复类.name属性报错 #

若仍出现.name相关TypeError：

• 避免在注入装饰器中使用.name，直接传入类本身（如@InjectModel(MyModel)而非MyModel.name）
• 确保Jest配置未开启代码压缩或Tree Shaking，保留类的原始名称

额外检查项 #

• 确认@nestjs/core、@nestjs/graphql、jest、babel-jest等依赖版本相互兼容（优先使用NestJS CLI初始化的默认版本组合）
• 不要在测试中直接导入未被测试模块包裹的第三方装饰器模块，避免解析冲突

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