Nestjs中typeorm与@nestjs/typeorm版本冲突MissingDriverError报错解决

@nestjs/typeorm@8.0.3 仅适配 typeorm 0.2.x 系列版本，出现MissingDriverError: Wrong driver: "undefined" given报错的核心原因是依赖安装时自动拉取了不兼容的typeorm版本（多为误升级到0.3.x版本），两者API不匹配导致数据库驱动参数读取失败。此前项目可正常运行是因为包管理器锁文件固定了兼容的子依赖版本，本次重新安装时^版本号前缀允许拉取同主版本下的最新迭代版本，触发版本冲突。

• 固定依赖精确版本，去掉版本号前的^前缀，避免包管理器自动拉取不兼容更新，修改package.json中对应依赖项为：

"dependencies": {
  "@nestjs/typeorm": "8.0.3",
  "typeorm": "0.2.45"
}

• 清理残留依赖和锁文件，彻底清除冲突版本缓存，根据你使用的包管理器执行对应命令：
  • npm 环境：

  rm -rf node_modules package-lock.json
  npm install
  

  • yarn 环境：

  rm -rf node_modules yarn.lock
  yarn install
  

  • pnpm 环境：

  rm -rf node_modules pnpm-lock.yaml
  pnpm install
  

• 校验数据库配置正确性，确认TypeORM初始化配置中type字段传入了正确的驱动名称，不存在读取env变量失败传undefined的情况，标准配置示例：

TypeOrmModule.forRoot({
  type: 'mysql', // 此处替换为你实际使用的数据库类型，如postgres/mariadb/sqlite等，取值必须在报错提示的支持驱动列表内
  host: process.env.DB_HOST,
  port: parseInt(process.env.DB_PORT, 10),
  username: process.env.DB_USERNAME,
  password: process.env.DB_PASSWORD,
  database: process.env.DB_DATABASE,
  autoLoadEntities: true,
  synchronize: false,
})

注意：如果通过.env文件读取数据库类型配置，需确认变量名拼写完全一致，避免读取到空值传入type字段。

• 若执行上述步骤后仍提示版本冲突，执行包管理器依赖检查命令确认是否有其他第三方包强制引入高版本typeorm：

  # npm环境执行
  npm ls typeorm
  # yarn环境执行
  yarn why typeorm
  # pnpm环境执行
  pnpm ls typeorm
  

  确认存在其他依赖强制拉高typeorm版本时，在package.json根节点增加版本强制覆盖配置，锁死typeorm版本：
  • npm 8.3+ 版本添加overrides字段：

  "overrides": {
    "typeorm": "0.2.45"
  }
  

  • yarn/pnpm 环境添加resolutions字段：

  "resolutions": {
    "typeorm": "0.2.45"
  }
  

  添加完成后重新执行清理依赖、重新安装的步骤即可。

内容的提问来源于stack exchange，提问作者Nur Uçcar