NestJS v9集成Cosmos DB遇依赖错误，降级v8正常求解决

问题详情 #

在NestJS v9环境中导入@nestjs/azure-database模块时，触发以下依赖解析错误：

Nest can't resolve dependencies of the AzureCosmosDbCoreModule (COSMOS_DB_CONNECTION_NAME, ?). Please make sure that the argument ModuleRef at index [1] is available in the AzureCosmosDbCoreModule context.

Potential solutions:
- If ModuleRef is a provider, is it part of the current AzureCosmosDbCoreModule?
- If ModuleRef is exported from a separate @Module, is that module imported within AzureCosmosDbCoreModule?
  @Module({
    imports: [ /* the Module containing ModuleRef */ ]
  })

将NestJS降级到v8版本后，相同代码可正常运行。

使用代码 #

import { AzureCosmosDbModule } from '@nestjs/azure-database';
import { Module } from '@nestjs/common'; 
import { AppConfigModule } from '../shared/config/app-config.module'; 
import { AppController } from './app.controller';
import { AppService } from './app.service';

@Module({
  imports: [
    AppConfigModule, 
    AzureCosmosDbModule.forRootAsync({
      imports: [AppConfigModule],
      useFactory: async (cfg: AppConfigModule) => ({
        endpoint: cfg.get<string>('AZURE_COSMOS_DB_ENDPOINT'),
        dbName: cfg.get<string>('AZURE_COSMOS_DB_TEST_NAME'),
        key: cfg.get<string>('AZURE_COSMOS_DB_KEY'),
      }),
      inject: [AppConfigModule],
    }), 
  ],
  controllers: [AppController],
  providers: [AppService],
})
 
export class AppModule {}

依赖对比 #

• 报错项目依赖（Node v16.16.0）：

  "@azure/cosmos": "^3.17.0", 
    "@nestjs/azure-database": "^2.3.0",
    "@nestjs/common": "^9.0.0", 
    "@nestjs/core": "^9.0.0", 
  

• 正常运行项目依赖（Node v16.16.0）：

  "@nestjs/azure-database": "^2.3.0",
    "@nestjs/common": "^8.0.0",
    "@nestjs/core": "^8.0.0",
  

问题原因 #

@nestjs/azure-database v2.3.0版本未适配NestJS v9的依赖注入逻辑变更。NestJS v9对ModuleRef的获取方式和模块上下文处理做了调整，而该版本的Azure数据库模块仍基于NestJS v8的逻辑实现，导致无法在模块上下文解析ModuleRef依赖。

解决方案 #

1. 升级@nestjs/azure-database到兼容版本 #

该包的v3.x及以上版本已适配NestJS v9，执行以下命令升级：

npm install @nestjs/azure-database@latest

或指定版本安装：

npm install @nestjs/azure-database@^3.0.0

2. 临时降级NestJS到v8版本 #

若暂无法升级Azure数据库模块，可保持NestJS v8版本运行，此方案已验证可行。

3. 手动补充依赖注入（不推荐） #

若需临时适配，可尝试在模块导入时手动提供ModuleRef，但此方法需修改模块内部逻辑，仅作为应急方案，不建议长期使用。

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