Docker容器无法通过环境变量连接数据库的原因排查

核心原因1：容器内的localhost指向容器自身，而非宿主机 #

你的.env里配置DB_HOST=localhost，但容器有独立的网络栈，这里的localhost指的是容器内部，不是运行数据库的宿主机或其他容器。如果你的PostgreSQL不在这个Node容器里，应用必然无法连接。

解决方式： #

• 若数据库在宿主机：
  • Linux/macOS：将DB_HOST改为host.docker.internal（Docker内置的宿主机别名）
  • Windows：查看Docker分配的宿主机IP（通常是192.168.99.100），替换localhost
• 若数据库在另一个Docker容器：
  1. 创建自定义Docker网络：docker network create chat-network
  2. 启动数据库容器时加入该网络：docker run --name postgres-db --network chat-network ... postgres
  3. 将.env里的DB_HOST改为数据库容器名称postgres-db，再启动Node容器时加入同一网络：docker run -p 3000:3000 --network chat-network ... your-node-image

核心原因2：.env文件未被注入容器 #

你的Dockerfile中没有复制.env到容器内，且docker run命令也没有传递环境变量参数，导致应用无法读取数据库配置信息。

解决方式： #

• 方式1：修改Dockerfile，添加复制.env的步骤：

  FROM node:14
  
  WORKDIR /app
  
  COPY package*.json ./
  COPY .env ./  # 新增这行
  
  RUN npm install --force
  
  COPY . .
  
  ENV NODE_ENV=production
  
  EXPOSE 3000
  
  CMD ["node", "dist/main"]
  

  注意：如果有.dockerignore文件，确保没有忽略.env。
• 方式2：运行容器时通过--env-file加载本地.env：

  docker run -p 3000:3000 --env-file .env your-node-image-name
  

• 方式3：逐个传递环境变量（适合敏感信息不想暴露在文件中的场景）：

  docker run -p 3000:3000 \
    -e DB_HOST=host.docker.internal \
    -e DB_PORT=5432 \
    -e DB_USERNAME=postgres \
    -e DB_PASSWORD=root \
    -e DB_DATABASE=chat \
    -e SECRET_KEY='qwerty' \
    your-node-image-name
  

核心原因3：数据库未允许外部连接 #

如果数据库在宿主机，默认PostgreSQL仅监听localhost，会拒绝来自容器的跨网络连接；或者宿主机防火墙/安全组阻止了5432端口的访问。

解决方式： #

1. 修改PostgreSQL配置文件postgresql.conf，将listen_addresses设置为*，允许监听所有IP：

   listen_addresses = '*'
   

2. 修改pg_hba.conf，添加允许Docker容器IP段连接的规则（Docker默认网桥IP段为172.17.0.0/16）：

   host all all 172.17.0.0/16 md5
   

3. 重启PostgreSQL服务，确保配置生效。
4. 检查宿主机防火墙，开放5432端口的入站规则。

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