NestJS 9集成RabbitMQ时遇TypeError: this.metadataScanner.getAllMethodNames is not a function

核心原因 #

该错误几乎都是NestJS核心依赖版本不匹配，或第三方包与NestJS 9不兼容导致MetadataScanner实例无法正常初始化。

排查步骤 #

• 核对NestJS核心包版本一致性：
  执行命令 npm list @nestjs/core @nestjs/microservices @nestjs/common，确认所有@nestjs开头的包主版本（9.x）完全一致，杜绝混合版本的情况。
• 清理并重装依赖：
  删除node_modules和package-lock.json/yarn.lock，再执行npm install/yarn install，消除缓存导致的版本冲突。
• 排查第三方插件兼容性：
  如果你用了自定义RabbitMQ装饰器、第三方Nest插件，确认这些包明确支持NestJS 9，旧版本插件可能依赖NestJS 8的API引发错误。
• 验证MetadataScanner使用方式：
  若代码中手动实例化了MetadataScanner，必须通过DI容器注入，而非直接new，正确写法：

  import { MetadataScanner } from '@nestjs/core';
  
  constructor(private readonly metadataScanner: MetadataScanner) {}
  

快速修复 #

1. 统一NestJS依赖版本：
   在package.json中强制指定所有@nestjs包为同一版本（比如和你的@nestjs/microservices 9.4.1保持一致）：

   {
     "dependencies": {
       "@nestjs/common": "9.4.1",
       "@nestjs/core": "9.4.1",
       "@nestjs/microservices": "9.4.1"
       // 其他依赖保留
     }
   }
   

   保存后重装依赖即可。
2. 确认RabbitMQ传输器依赖：
   无需手动安装额外的RabbitMQ客户端依赖，@nestjs/microservices 9.4.1自带兼容的传输器，重装依赖可解决底层依赖版本不兼容问题。

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