GitLab CI/CD流水线NestJS测试无法连接MongoDB Atlas求助

排查方向及解决方案 #

1. 验证环境变量传递完整性
   在GitLab CI的测试脚本中添加打印命令，确认连接字符串是否完整：

   test:
     script:
       - echo "Mongo URI: $MONGO_URI" # 打印变量确认内容
       - npm install
       - npm run test
   

   重点检查字符串是否包含特殊字符（如@、&）被转义或截断，若有需对连接字符串进行URL编码。

2. 切换MongoDB Atlas连接格式
   改用SRV格式的连接字符串（mongodb+srv://<user>:<password>@cluster0.mongodb.net/）替代传统的mongodb://格式。SRV格式会自动解析集群地址与端口，能规避部分网络代理导致的连接问题。

3. 同步依赖版本
   确保CI环境安装的mongoose版本与本地完全一致：

   • 提交package-lock.json或yarn.lock文件到仓库
   • 在CI脚本中使用npm ci替代npm install，强制安装锁定版本的依赖

4. 确认测试代码中应用初始化时机
   确保Pactum测试在NestJS应用模块完全初始化后执行：

   beforeAll(async () => {
     const moduleFixture = await Test.createTestingModule({
       imports: [AppModule],
     }).compile();
     app = moduleFixture.createNestApplication();
     await app.init(); // 等待应用初始化完成
   });
   

5. 检查数据库用户权限
   登录MongoDB Atlas控制台，确认使用的数据库用户拥有readWrite权限，且用户名、密码与环境变量中的内容完全匹配。

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