Docker入门者咨询：如何在容器中搭配Postgres运行Node应用测试

嘿，作为Docker新手，你这个需求很典型——用真实数据库跑测试比内存数据库更贴近生产环境，但当前的Dockerfile有几个可以优化的点，尤其是把Postgres和Node塞在同一个容器里其实不符合Docker的单职责原则，后续维护会很麻烦。我给你两个方案，优先推荐第一个，更符合最佳实践：

方案一：用Docker Compose分离Postgres和Node服务（强烈推荐） #

把数据库和测试服务拆成两个独立容器，用Compose管理它们的依赖和启动顺序，调试和扩展都更灵活。

第一步：创建docker-compose.yml文件 #

version: '3.8'
services:
  postgres:
    image: postgres:alpine
    environment:
      # 自定义测试库的用户、密码和库名，可根据需求修改
      POSTGRES_USER: test_user
      POSTGRES_PASSWORD: test_pass
      POSTGRES_DB: test_db
    ports:
      - "5432:5432" # 映射本地端口，方便本地调试数据库
    healthcheck:
      # 检查Postgres是否就绪的命令
      test: ["CMD-SHELL", "pg_isready -U test_user -d test_db"]
      interval: 5s
      timeout: 5s
      retries: 5

  node-test:
    build: . # 用当前目录的Dockerfile构建Node测试镜像
    depends_on:
      # 只有Postgres健康就绪后，才启动Node测试
      postgres:
        condition: service_healthy
    environment:
      # 直接传递数据库连接字符串，也可以用.env文件替代
      - DATABASE_URL=postgres://test_user:test_pass@postgres:5432/test_db
    volumes:
      # 挂载本地代码和依赖文件，修改代码无需重新构建镜像
      - ./src:/app/src
      - ./package.json:/app/package.json
      - ./package-lock.json:/app/package-lock.json

第二步：调整Node应用的Dockerfile #

现在不需要在Node镜像里安装Postgres，专注于测试环境即可：

# 选用匹配你项目的Node版本，比如18-alpine（轻量且安全）
FROM node:18-alpine

# 设置规范的工作目录，避免文件路径混乱
WORKDIR /app

# 先复制package文件，利用Docker缓存——只有依赖变更时才会重新安装
COPY package*.json ./

# 用npm ci代替npm install，容器/CI环境下更稳定，严格按lock文件安装依赖
RUN npm ci

# 复制源代码和测试配置文件
COPY src ./src
COPY .env.testing ./.env

# 运行测试命令
CMD ["npm", "run", "coverage"]

第三步：启动测试 #

确保你的.env.testing里的数据库连接配置和Compose中的DATABASE_URL一致（或者直接用Compose传递的环境变量覆盖），然后执行：

docker-compose up --build

Compose会自动先启动Postgres，等它完全就绪后再启动Node容器执行测试，完美解决数据库未就绪导致的连接失败问题。

方案二：坚持在同一个容器运行（不推荐，但满足需求） #

如果你一定要把Postgres和Node放在同一个容器里，必须解决Postgres启动慢的问题——直接跑npm测试会因为数据库还未就绪而失败。调整Dockerfile如下：

FROM postgres:alpine

# 安装Node.js
RUN apk add --update nodejs nodejs-npm

# 设置工作目录
WORKDIR /app

# 复制项目文件
COPY src ./src
COPY .env.testing ./.env
COPY package*.json ./

# 编写启动脚本：先启动Postgres，等它就绪后再跑测试
RUN echo '#!/bin/sh' > /start.sh && \
    echo 'postgres -D /var/lib/postgresql/data &' >> /start.sh && \
    echo 'until pg_isready -U postgres; do sleep 1; done' >> /start.sh && \
    echo 'npm install && npm run coverage' >> /start.sh && \
    chmod +x /start.sh

# 设置Postgres默认环境变量（可根据需求修改）
ENV POSTGRES_USER=postgres
ENV POSTGRES_PASSWORD=postgres
ENV POSTGRES_DB=postgres

# 运行自定义启动脚本
CMD ["/start.sh"]

注意：你的.env.testing里的数据库连接要改成postgres://postgres:postgres@localhost:5432/postgres，因为Postgres和Node在同一个容器里，用localhost即可访问。

但还是要提醒你，这种方式违背了Docker单职责原则，容器出问题时很难排查是数据库还是Node的问题，升级其中一个服务也不方便，尽量优先选择方案一。

额外小贴士 #

• 开发时用Compose的卷挂载，修改代码后无需重新构建镜像，重启容器就能跑新测试
• 用npm ci代替npm install，容器环境中更稳定，避免依赖版本不一致
• 给Postgres加healthcheck是关键，确保数据库真的能接受连接后再执行测试

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