我之前Docker化Node+Postgres项目时也踩过几乎一样的坑，给你梳理几个最可能的原因和对应的解决办法：

1. 数据库连接字符串用错了主机名 #

这是最常见的问题！你的Node应用如果硬编码了localhost:5432作为数据库地址，在Docker容器里是行不通的——容器里的localhost指的是Node容器自己，而不是Postgres容器。

你需要把连接地址改成docker-compose里Postgres服务的名称postgres，比如连接字符串应该写成：
postgres://postgres:你的密码@postgres:5432/你的数据库名

建议把这个配置放到环境变量里（比如docker-compose的environment字段），然后Node代码里通过process.env.DATABASE_URL读取，这样更灵活也更安全。

2. 忽略了depends_on的局限性 #

你的docker-compose里用了depends_on: [postgres]，但这个配置只保证Postgres容器先启动，不保证Postgres服务已经完全就绪（比如数据库初始化完成、可以接受连接）。如果Node应用启动时Postgres还没准备好，就会连接失败。

解决这个问题最好的方式是给Postgres服务加上健康检查，让Node容器等Postgres真正就绪后再启动：

• 给postgres服务添加healthcheck配置，检查数据库是否能正常连接
• 修改app服务的depends_on，指定等待Postgres健康检查通过

3. Dockerfile和项目配置的小优化 #

还有几个细节能帮你避免其他潜在问题：

• 添加.dockerignore文件，排除node_modules、.git等不必要的文件，避免把本地的依赖复制到容器里导致兼容性问题
• 不要用node:latest和postgres:latest，用具体的版本号（比如node:18-alpine、postgres:15-alpine），保证环境一致
• 把Node容器的工作目录设为/app，让文件结构更清晰

修改后的完整配置示例 #

.dockerignore

node_modules
npm-debug.log
.git
.gitignore
.env

Dockerfile

FROM node:18-alpine
WORKDIR /app
# 先复制package.json和package-lock.json，利用Docker缓存减少构建时间
COPY package*.json ./
RUN npm install --only=production
# 再复制其他项目文件
COPY . .
EXPOSE 5000
CMD ["npm", "start"]

docker-compose.yml

version: '3.8'
services:
  postgres:
    container_name: postgres
    image: postgres:15-alpine
    environment:
      POSTGRES_PASSWORD: your_password
      POSTGRES_USER: postgres
      POSTGRES_DB: your_db_name
    ports:
      - '5432:5432'
    # 健康检查：每隔5秒检查数据库是否就绪
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres -d your_db_name"]
      interval: 5s
      timeout: 5s
      retries: 5
    # 持久化数据库数据，避免容器重启丢失数据
    volumes:
      - postgres_data:/var/lib/postgresql/data

  app:
    container_name: node-postgres
    restart: always
    build: .
    depends_on:
      postgres:
        condition: service_healthy
    # 传递数据库连接字符串到Node应用
    environment:
      DATABASE_URL: postgres://postgres:your_password@postgres:5432/your_db_name
    ports:
      - '5000:5000'

# 定义数据卷用于持久化Postgres数据
volumes:
  postgres_data:

最后记得检查你的Node应用代码，确保是从环境变量读取数据库连接配置，而不是硬编码地址。这样调整后，应该就能顺利建立连接了！

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