Docker化Node.js应用遇SequelizeHostNotFoundError无法连接PostgreSQL

1. 修正Sequelize的host配置 #

将Sequelize配置中的host字段直接替换为PostgreSQL容器的实际名称[container-name]——Docker同一网络内的容器可以通过容器名直接解析通信。修改后的代码：

const sequelize = new Sequelize('postgres', 'postgres', 'mysecretpassword', {
  host: '[container-name]', // 此处填写你的PostgreSQL容器名
  dialect: 'postgres',
});

2. 手动验证容器间的DNS解析与连通性 #

进入应用容器内部，通过命令验证是否能正常访问数据库容器：

• 测试DNS解析：执行ping [container-name]，如果能返回IP并收到响应，说明解析正常
• 测试端口连通：执行nc -zv [container-name] 5432，如果显示succeeded!，说明数据库端口可访问

如果这两步失败，先确认容器是否处于同一网络：

• 查看数据库容器所属网络：docker inspect [container-name] | grep Networks
• 查看应用容器所属网络：docker inspect [app-container-name] | grep Networks
  确保两者的网络名称完全一致。

3. 针对Docker Compose的额外检查 #

如果用Docker Compose管理容器，注意两点：

• 确保两个服务配置在同一个自定义网络中（默认bridge网络也可用，但自定义网络的DNS解析更稳定）
• 应用的Sequelize配置里，host可以直接填写Compose中PostgreSQL服务的名称（比如服务名为postgres，则host设为postgres），Compose会自动维护服务名到容器的DNS映射

示例Compose配置：

version: '3.8'
services:
  node-app:
    build: .
    networks:
      - app-net
  postgres-db:
    image: postgres:15
    container_name: [container-name]
    environment:
      POSTGRES_PASSWORD: mysecretpassword
    networks:
      - app-net
networks:
  app-net:
    driver: bridge

4. 禁止使用localhost作为host配置 #

本地运行时localhost可以访问宿主机的PostgreSQL，但Docker容器内的localhost指向容器自身而非宿主机，容器化应用绝对不能用localhost作为数据库host。

5. 清理Docker DNS缓存 #

如果以上步骤都验证正常但仍解析失败，可能是Docker DNS缓存异常：

• 重启应用容器和数据库容器：docker restart [app-container-name] [container-name]
• 极端情况可重启Docker服务：Linux下执行systemctl restart docker，Windows/macOS在Docker Desktop中重启服务

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