如何通过Docker Compose运行Node.js项目的Mocha REST API测试

解决镜像依赖问题：无需提前构建/注释配置 #

你当前的web-tests服务直接引用现成镜像，才会出现首次运行找不到镜像的问题，直接修改docker-compose配置让web-tests复用web服务的构建规则即可：

• 给web-tests服务配置和web完全相同的build上下文，docker compose启动时会自动按依赖顺序完成镜像构建，不需要手动提前操作
  参考配置片段：

services:
  web:
    build: .
    # 保留你原有web服务的端口、环境变量、卷挂载等配置
  mariadb:
    # 保留原有mariadb配置
  web-tests:
    build: . # 和web服务共用同一套构建规则，自动构建不需要提前准备镜像
    command: npm run test # 覆盖web服务的默认启动命令，仅执行测试
    depends_on:
      - web
      - mariadb
    environment:
      # 复用web服务的环境变量，保证数据库连接等配置和web一致

解决服务启动时序问题：等待数据库、web服务完全就绪 #

mocha的--timeout参数是单测试用例的执行超时限制，不会等待外部依赖服务启动，所以配置不生效。你需要额外做服务就绪检测，两种实现方案可选：

方案1：用外部等待工具，无侵入代码修改 #

把轻量等待脚本wait-for-it放到项目根目录，修改web-tests的启动命令，先检测数据库、web端口连通性再启动测试：

command: ["./wait-for-it", "mariadb:3306", "--", "./wait-for-it", "web:3000", "--", "npm", "run", "test"]

方案2：用mocha全局前置钩子，兼容本地/容器双场景 #

在movie.ts最顶部添加全局前置钩子，测试执行前主动检测服务可用性，钩子的超时配置优先级高于全局参数：

// 全局前置钩子，所有测试用例执行前先跑这段逻辑
before(async function() {
  this.timeout(20000); // 这里单独设置的超时会覆盖全局配置，预留足够启动时间
  // 第一步：循环检测数据库连通性
  let dbConnected = false;
  while (!dbConnected) {
    try {
      // 替换为你项目的数据库连接校验逻辑
      await databaseClient.authenticate();
      dbConnected = true;
    } catch (err) {
      // 连接失败等待1秒重试
      await new Promise(resolve => setTimeout(resolve, 1000));
    }
  }
  // 第二步：循环检测web服务可用性
  let webReady = false;
  while (!webReady) {
    try {
      // 可以给web服务加个简单的健康检查接口，返回200即代表服务就绪
      await chai.request('http://web:3000').get('/health');
      webReady = true;
    } catch (err) {
      await new Promise(resolve => setTimeout(resolve, 1000));
    }
  }
});

可选优化 #

如果平时启动服务不需要自动跑测试，可以把web-tests的配置单独放到docker-compose.test.yml覆盖文件里，跑测试时执行命令docker compose -f docker-compose.yml -f docker-compose.test.yml up --abort-on-container-exit，测试跑完后所有容器会自动退出，不会占用资源。

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