在 NestJS 中配置 MongoDB 连接时，一定要根据不同运行环境进行区分，千万不要把连接信息直接硬编码到项目里。像 MONGODB_URI 这类关键配置，建议统一放到 .env 文件中管理，并结合 ConfigService 动态读取。同时，连接参数中应显式开启 useNewUrlParser 和 useUnifiedTopology。如果数据库密码包含特殊字符，还必须先进行 URL 编码。对于开发、测试、生产等多环境场景，authSource 和 replicaSet 等参数也要确保配置无误，避免连接异常或认证失败。
连接字符串必须按环境区分，不能硬编码
在开发环境、测试环境和生产环境中，MongoDB 的地址、认证账号以及数据库名称通常都不一样。如果直接写死 mongodb://localhost:27017/mydb 这类连接字符串，很容易在部署时出现连接失败，或者误连到错误的数据库。
更推荐的做法，是将 MongoDB 连接配置统一抽离到环境变量中，再通过 NODE_ENV 控制不同环境的加载逻辑：
.env.development：包含MONGODB_URI=mongodb://localhost:27017/myapp_dev.env.production：包含MONGODB_URI=mongodb://user:pass@prod-mongo:27017/myapp_prod?authSource=admin- 在
AppModule中通过ConfigService读取：configService.get('MONGODB_URI')
必须启用 useNewUrlParser 和 useUnifiedTopology
如果没有加上这两个连接选项，NestJS 项目启动时往往会出现报错：DeprecationWarning: current URL string parser is deprecated，同时还可能导致 MongoDB 连接不稳定、超时，甚至影响服务正常运行。
虽然新版 Mongoose（≥6.x）通常已经默认启用这些配置，但在 NestJS 的 @nestjs/mongoose 封装中，依然建议显式传入参数，便于保证兼容性和连接稳定性：
MongooseModule.forRoot(uri, {
useNewUrlParser: true,
useUnifiedTopology: true,
// 其他可选：bufferCommands: false, bufferMaxEntries: 0
})
另外要注意，如果项目部署在 Docker、容器环境或远程 MongoDB 集群中，最好额外配置 connectTimeoutMS 和 socketTimeoutMS，以防止连接长时间卡住。
密码和特殊字符必须 URL 编码
当 MongoDB 用户密码中包含 @、/、: 等特殊字符时，如果没有先编码，就会导致连接字符串解析错误，常见表现就是连接超时，或者直接提示 Authentication failed。
比如密码是 pa@ss/w0rd，如果直接拼接到 URI 中，就会变成：
mongodb://user:pa@ss/w0rd@host:27017/db
这样会被错误解析为 host 是 ss/w0rd@host，显然不是正确结果。更稳妥的处理方式有以下几种：
- 使用
encodeURIComponent()对用户名和密码进行编码 - 或者使用
MongooseModule.forRootAsync()动态构造 URI - 更推荐第二种方式，可以有效避免手动拼接字符串带来的错误
多环境配置容易漏掉 authSource 和 replicaSet
在本地单机开发时，很多人会忽略 authSource 参数，但到了生产环境，MongoDB 往往已经开启权限控制，而且用户通常不是在目标数据库中创建的，而是在 admin 库中创建。如果没有显式指定 authSource=admin，就很容易出现认证失败的问题。
此外，如果使用的是副本集架构（例如 MongoDB Atlas 这类云数据库服务），连接 URI 中通常还必须带上 replicaSet 参数。否则即使表面上连接成功，也可能在写入数据时出现失败：
mongodb://user:pass@host1:27017,host2:27017/mydb?replicaSet=rs0&authSource=admin
这个参数在本地单节点开发环境中可以省略，但一旦切换到生产环境就非常容易遗漏。更麻烦的是，这类问题往往不会在第一时间暴露出来，而是在执行写操作时才出现静默失败，排查成本也会更高。
