使用 Docker 进行 JavaScript 集成测试：完整指南

使用 Docker 进行 JavaScript 集成测试：从 A 到 Z

在现代 Web 开发中，代码质量不仅仅是一个指标，更是产品稳定性的保障。集成测试在测试金字塔中占据关键位置，它允许我们验证不同模块、数据库、外部 API 和服务之间的交互。然而，为这类测试配置隔离且可重现的环境常常令人头疼。这时，Docker——一种容器化工具——便派上了用场，它非常适合创建干净、可重复的测试环境。

在本文中，我们将探讨如何使用 Docker 为 JavaScript (Node.js) 应用程序组织集成测试。您将学习如何启动测试数据库、在容器中运行依赖项，以及编写可轻松集成到 CI/CD 流水线中的高效测试。

1. 为什么 Docker 是集成测试的理想选择？

传统的集成测试方法通常需要在每台开发机器或 CI 服务器上手动配置环境。这会导致“在我机器上能运行”的问题。Docker 从根本上解决了这个问题：

• 隔离性：每个测试都在干净的容器中运行，消除了先前运行产生的副作用影响。
• 可重现性：相同环境（Node.js 版本、数据库、系统库）保证在本地开发机器、构建服务器和生产环境中都能一致运行。
• 依赖管理：您只需一条命令 docker-compose up -d 即可轻松启动复杂的基础设施（如 Redis、PostgreSQL、RabbitMQ）。
• 速度：与虚拟机不同，容器可以在几秒钟内启动。Docker 会缓存层，从而加速重复构建。

在 Node.js 的上下文中，Docker 允许您在不离开开发环境的情况下“模拟”外部服务。您无需调用生产 API，而是启动一个测试容器，例如使用 json-server 或 testcontainers。

2. 配置用于测试的 Node.js 项目

假设我们有一个简单的 Express 应用程序，它将用户保存到 PostgreSQL 中。我们的任务是测试 POST /users 端点。

项目结构：

project/├── src/│   ├── app.js│   ├── db.js│   └── routes/│       └── users.js├── test/│   └── integration/│       └── users.test.js├── docker-compose.test.yml├── Dockerfile├── package.json└── .env.test

对于测试，我们将使用流行的技术栈：Mocha（测试框架）+ Chai（断言库）+ Supertest（HTTP 测试库）。

安装依赖项：

npm install --save-dev mocha chai supertest

package.json 文件应包含用于运行测试的脚本：

{  "scripts": {    "test:integration": "mocha test/integration/**/*.test.js --timeout 10000"  }}

3. 为测试创建 Docker 环境

关键文件是 docker-compose.test.yml。它描述了测试所需的服务。

version: '3.8'

services:  app-test:    build:      context: .      dockerfile: Dockerfile    environment:      - NODE_ENV=test      - DB_HOST=postgres-test      - DB_PORT=5432      - DB_USER=test_user      - DB_PASSWORD=test_pass      - DB_NAME=test_db    depends_on:      postgres-test:        condition: service_healthy    command: ["npm", "run", "test:integration"]

  postgres-test:    image: postgres:15-alpine    environment:      POSTGRES_USER: test_user      POSTGRES_PASSWORD: test_