NestJS中TypeORM连接MongoDB提示认证失败的问题如何解决

问题原因 #

• 缺省认证数据库配置：使用mongosh连接时，如果没有指定认证库，默认会读取你创建用户所属的库（绝大多数场景下MongoDB管理用户都会创建在admin库下），但你当前的TypeORM配置未指定authSource参数，TypeORM会默认将你配置的业务库MONGO_DATABASE作为认证库，导致身份校验失败。
• 特殊字符未转义：如果你的MongoDB密码包含@、:、/这类URL特殊字符，TypeORM 0.2.x版本不会自动做转义处理，也会触发认证失败。
• 版本兼容问题：TypeORM 0.2.38版本存在MongoDB参数适配的已知bug，部分配置项未显式传入时不会生效。

解决方案 #

1. 优先在TypeORM配置中新增authSource参数，绝大多数场景下认证库为admin，修改后的配置如下：

TypeOrmModule.forRootAsync({
      imports: [ConfigModule],
      inject: [ConfigService],
      useFactory: async (configService: ConfigService) => {
        const username = configService.get('MONGO_USER');
        const password = configService.get('MONGO_PASS');
        const database = configService.get('MONGO_DATABASE');
        const host = configService.get('MONGO_HOST');
        const port = configService.get('MONGO_PORT');
        return {
          type: 'mongodb',
          host,
          port,
          username,
          password,
          database,
          authSource: 'admin', // 如果你创建用户时指定了其他认证库，替换为对应库名即可
          entities: [__dirname + '/**/*.entity{.ts,.js}'],
          synchronize: true,
        };
      },

2. 如果密码包含特殊字符，可直接使用完整连接串配置，避免拆分参数导致的转义问题，配置如下：

TypeOrmModule.forRootAsync({
      imports: [ConfigModule],
      inject: [ConfigService],
      useFactory: async (configService: ConfigService) => {
        return {
          type: 'mongodb',
          url: 'mongodb://xxx:pass@42.212.159.109:27017', // 直接填入你本地能连接成功的完整连接串即可
          entities: [__dirname + '/**/*.entity{.ts,.js}'],
          synchronize: true,
        };
      },

3. 以上操作均无效的话，可将TypeORM升级到0.2.x分支的最新小版本，或降级到0.2.34验证兼容性问题。

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